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believe it's incredibly important to make things. It doesn't really 
matter what you make: a chair, a work of art, or an electronic 
gadget. But you should be able to look around you and think 

*[ made that!” 

Lots of folks tell us that they love the Raspberry Pi, the little 
computer at the heart of the digital maker movement. But too many 
people buy a Raspberry Pi and never really make anything with it. Editor of The MagPi 

Far too much of our world is about buying, rather than making. So ee 
this month we’re all committing to a #MonthOfMaking. We want 


Lucy 
Hattersley 


robots. She speaks 
French (badly) and 


everybody to make something this month and share it with other eee ee 
ne day she'll get 
makers. Let’s inspire each other to become makers, not buyers. Mai peed: 


magpi.cc 


Obviously, I think it should be something you make with a Raspberry 
Pi. And we’ve got eleven projects to help you get started. But truth be 
told, 1l be happy to see all type of makes this March. 

For my own part, I made a Teachable Machine this month using 
Google's new Coral USB Accelerator kit. The joy I felt when I taught my 
Raspberry Pi to recognise a banana! I can't tell you... 

Anyway, I hope you join us in 
making something this month. And 
don't forget to share it with us and 
the rest of the community. 


CIAL RASPBERRY PI MAGAZINE 


3 vol The 


Lucy Hattersley Editor 


magpicc | 03 


Maágpi 


ontents 


Issue 78 » March 2019 


2 £:MonthOfMaking 


06 The world of Pi 
92 Your letters 

97 Next month 
98 Final word 


Project Showcases 


14 Tortoise Fridge 

18 Tomography Beamline 

20 Heverlee Sjoelen 

22 Telescope Mount 

24 StereoPi 

26 Firefighter Monitoring System 


Sjoelen Shuffleboard 


? 


t 


Firefighter Monitor 


DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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Raspberry P1 opens 
Cambridge store 


Learn all about Raspberry Pi and buy electronics components - Lucy Hattersley 
shops at the all-new official store 


store in the Grand Arcade, Cambridge. 

We caught up with Gordon Hollingworth, 
Director of Software Engineering at Raspberry 
Pi - one of the people instrumental in designing 
the store - to ask why Raspberry Pi was opening 
a retail environment. 

The project booths are “really important,” says 
Gordon. “I wanted them to be inviting and easy 
to navigate, I didn't want a list of instructions 
printed on paper, so we use the touchscreen in 
kiosk mode to display them." 


R aspberry Pi has opened an official retail 


m The store concept is about trying to get 
closer to a less connected demographic El 


W Ashelf full of 
Babbage bears! 


Reach out 

“The store concept is about trying to get closer 
to a less connected demographic, people who 
aren’t involved with technology, and show them 
that coding isn’t an inexplicable dark science 
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A Gordon Hollingworth, Director of Software Engineering at 
Raspberry Pi 


reserved only for a few. Instead show them that 
it is possible, with the right instructions and an 
inquisitive nature, to learn about computers and 
coding,” explains Gordon. 

At the end of the store is a ‘museum bar’. This 
glass table contains the first ever Raspberry Pi, 
a blue Brazilian Pi, red Chinese Pi boards, anda 
rare copy of The MagPi #40 with free Pi Zero. Plus 
prototype models of Raspberry Pi boards and cases. 


Behind the scenes 

The Raspberry Pi store has been gestating for 
“over six years,” Gordon reveals. But each year 
Gordon and Eben Upton, Raspberry Pi CEO and 
co-founder, “decided against it.” 

Things changed when Maplin closed all its 
stores in 2018. “With the demise of Maplin, we 
decided there was the possibility of recruiting 
just the right person to launch the store for us,” 
explains Gordon. 

Raspberry Pi is thinking about what comes 
next. “Who knows,” says Gordon, “maybe there 
will be a Raspberry Pi store in every city.” 


— 
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The swish facade of the 
Raspberry Pi store in 
Cambridge 


Visitors are encouraged 


to try out Raspberry Pi 
technology in-store 
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| coral.withgoogle.com 


Google 
releases 


Coral 


Introducing Coral, a new platform for building devices with local Al 
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oogle has launched Coral, a new platform 
G of hardware components and software 
tools featuring the Edge TPU to accelerate 
neural networks on local devices. The Coral 
USB Accelerator was designed as a pluggable 
accessory to bring the Edge TPU chip to 
Raspberry Pi boards. 
“Building upon our work with the original AIY 
kits, we’re delighted to introduce our new line 
of products that bring private, fast, and power- 


Ei We can't wait to see what 
prototypes the community 
comes up with @ 


efficient neural network acceleration right into 
your own projects," says Billy Rutledge, Google's 
Director of AIY and Coral teams. 
These on-device neural networks will enable 
makers to integrate fast and efficient AI 
features into their prototypes and projects while 
maintaining data privacy. Developers will use 
TensorFlow to create and train neural networks 
before compiling them to run on the Edge TPU 
boards using the software utilities provided. 


eases Coral 


Once the compiled network is installed, all of 
the inference is performed locally on the Edge 
TPU and not sent into the cloud, increasing 
performance without network latency and 
keeping user data local and under their control. 

The Coral platform also includes a collection 
of pre-trained, pre-compiled models to make it 
easy to get started. These pre-built models have 
been optimised for the Edge TPU, and software 
utilities allow developers to repurpose the 
models for their own use. 


Using the USB Accelerator 

See our tutorial on using the USB Accelerator 
to build a Teachable Machine (page 40) for an 
example of how Coral can bring local AI into 
your projects. 

The new Coral products and AIY kits are 
available now and can be picked up globally, 
including the UK and EU countries through 
Mouser Electronics (mouser.com). 

Coral products are welcome additions to 
the Raspberry Pi developer environment. 
Artificial intelligence remains one of the most 
creative parts of modern computing, and we 
can't wait to see what prototypes the community 
comes up with. El 
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A The Coral USB 
Accelerator 
connects toa 
Raspberry Pi via a 
USB type-A to USB 
type-C cable 


«4 The USB 
Accelerator 
contains an Edge 
TPU chip 


Google releases Coral | magpicc | 09 


3 ISSUES 
FROM £5 


on a quarterly subscription 


OFFICIAL | 


OFFICIAL 


Use the code MP-SAVE at checkout 


THE WORLD OF PI | Mag?i ME 


Official 
keyboard and mouse 


Raspberry Pi official keyboard and mouse 
now available. By Lucy Hattersley 


his month sees the launch of two new and white, to match the Official Case and other 
T products: The Official Raspberry Pi Keyboard Raspberry Pi products. 
& Hub and the Official Raspberry Pi Mouse. The Official Mouse is a three-button optical 
Both are designed to work with, and integrate with, mouse with a scroll wheel (also in fetching red 
the Raspberry Pi computers. and white). It also connects to the Raspberry Pi via 
The Official Raspberry Pi Keyboard & Hub is a a USB type-A connector. Both devices use wired 
full-sized 79-key keyboard that attaches to the connections rather than Bluetooth, which we think 
Raspberry Pi via a USB type-A to USB type-B cable. | makes more sense for Raspberry Pi (as it's easier 
On the rear of the keyboard are three more USB to set them up and you don't need to worry about 
2.0 type-A ports, adding a hub aspect to it. This charging or batteries). 
makes it ideal for attaching additional products The Official Keyboard & Hub is available now 
(including the new mouse). in the new Raspberry Pi Store in Cambridge for 
£18. The Official Mouse is also available in the 
T M em Red and white Cambridge store for £7. Both devices will be 
sitting next to the The keyboard is high-quality and ergonomic, widely available online and at other Raspberry Pi 
ER but fits neatly onto a desk. It's designed in red resellers shortly. El 


EN Y M Both devices use 


wired connections Ø 
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Can't make 
it to the 
| PI STORE? 


Check out our 


competition on 


A The Official Keyboard 
& Hub is a full-sized 
79-key keyboard 
designed to accompany 
the Raspberry Pi 
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CDP Studio is a development platform for industrial control systems, now coming with a free 


version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, l2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 

P.O. Box 144 

NO-6001 Alesund, Norway 


Tel: +47 990 80 900 
info@cdptech.com 
www.cdpstudio.com 


CDPStudio 
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Tortoise Fridge 


Chilly winters affect us all. Thanks to Pi-controlled heating, Stefan Wollner's 
tortoise enjoys a cosy hibernation year after year, as Rosie Hattersley discovers 


for all living creatures. We humans can simply 
add or remove a jumper or vest, but our 
domestic companions don't have that option. 

Tech enthusiast Stefan Wollner encountered 
exactly this issue when he moved home in 2015 and 
realised the basement was too warm for his pet 
Stefan Wollner tortoise, Pumba. Stefan had planned for the tortoise 
to spend the winter in a refrigerator - a common ploy 


S easonal temperature shifts can be a challenge 


Stefan works for for tortoise owners. However, the temperature of a 
a large insurance standard refrigerator can’t be constantly monitored 
company. He loves : " zs 
technology-and and the internal thermostat only provides a limited 
taught himself degree of temperature control. The warmest and 
programming. coldest settings of an average fridge vary just three 
magpi.cc/dioTvm degrees Celsius. 


In a flash of inspiration, Stefan realised that he 
could use a Raspberry Pi and a temperature sensor to 
keep watch on Pumba’s environment. For just a few 
euros, Stefan bought a DS18B20 temperature sensor 

nM y > The heart of the 
to place inside the refrigerator. The system checks the kitchen installation 
temperature once a minute and records the results ina E d nr 
database, which it then displays as a real-time graph. 
The sensor's findings are then acted upon by a cooling 
compressor connected to a 12V-to-230V switching 
relay, operated by the Raspberry Pi. 

Two small Pi- powered displays visually confirm 
everything is working as it should. One two-line 


VA m us display shows the fridge's current temperature and the 
prompte efan : 
Wollner to consider temperature of the basement; the other displays the 
how toadaptthe new time the refrigerator was last opened, and the current 
surroundings for his i 
tortoise's hibernation status of the cooling compressor. 


J- 
<> 13939 
BC) 
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» Three years of work 
have already gone 
into the project 


All sensors and switches 
are connected to the » The used 


circuit board refrigerator cost 
30 euros 


The central part 
of the system isa 
Raspberry Pi 


» Numerous 
components were 
adapted from a 
3D printer 


IU on ae le a. r > Stefan is currently 
; j | j j 27. : dis working on 

Scales to monitor 

Pumba's weight 


» Stefan's smart 
fridge wish-list 
includes an 

ultrasonic vaporiser 


Ns : 


The limit switch checks 
the opening and 
closing of the door 
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Whenever someone visits the basement, the 
backlight of both displays is activated by a PIR 
motion sensor. There’s no need for Stefan to 
visit the basement to check up, though: another 
Raspberry Pi shows this data on two additional LCD 
displays in the kitchen. If Stefan’s busy preparing 
food when he wants an update on Pumba’s 
environment, he simply presses a button on the 
kitchen display and gets an audible update. 


Ge39 1196 
Gsze osut 


m Next up is an ultrasonic 
vaporiser to regulate the 
air humidity @ 


A breath of fresh air 
Temperature control wasn't the only issue facing 
Stefan and his beloved tortoise. He also had to 
consider its oxygen supply. Whenever Stefan 
was at home, the fridge door would be opened 
regularly, refreshing the oxygen supply, but work 
and socialising often took him away from home. 
Stefan wasn't prepared to risk the unthinkable and 
let the oxygen supply run out. Instead, he created an 
automatic door-opening system with a linear motor 
that opens and closes the refrigerator door at preset 
times and checks the door has been closed properly. 
The (by now) very smart fridge automatically 
issues error messages, warnings, and notices, 
keeping Stefan abreast of any issues that might 
arise with his carapace-clad companion's living 
arrangements. Should he need to, he can even 
remotely adjust the temperature and the timing 
of the fridge door opening, to allow more or less 
oxygen into the hibernation centre. 


A AT-Cobbler Plus 
breakout board is 
used to wire the 
other electronics to 
the Raspberry Pi 


P Pumba enjoys 
chomping on flowers 


W Prototyping the 
project on a desk 


Emergency shutdown procedures 
Stefan has spent many hours making the perfect 
hibernation environment for Pumba. The whole 
shebang is also safe from intruders and electricity 
outages. A Raspberry Zero W secures the whole 
setup. This has its own sensor in the refrigerator 
which measures the temperature and switches off 
the system completely when the threshold value 
has been reached, and sends a notification. 

Stefan says, “Since I will probably never complete 
the work on this project, I am in the process of 
planning the next enhancements. Among other 
things I want to install in the near future are an 
ultrasonic vaporiser to regulate the air humidity 
and a scale for weight control." He also plans to 
automate what the tortoise is fed and when. Hl 
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Open door policy 


When no one's at home, the oxygen 
controller kicks in, automatically opening the 
fridge door at preset times to refresh the air supply 
so the resident can breathe easily. 


A range of sensors monitor the temperature in 
the fridge and the levels of oxygen available. 
LCD displays in the basement and kitchen show the 
current status of the fridge and when its door was 
last opened. 


03 Oblivious to his owner's Herculean efforts, 

Pumba luxuriates in a den of fresh leaves, 
precisely temperature-controlled and with ample 
fresh air and food. 


A The linear motor opens and closes 
the refrigerator at specified times 
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Raspberry P1 
Tomography Beamline 


This project creates 3D models in a very unusual way, and can 
be controlled by Twitter. Rob Zwetsloot tries to figure it out 


Emma 
Osbiston 


An undergraduate 
electronic 
engineering student 
who came up 

with the beamline 
concept while 
working at Diamond 
Light Source. 


magpi.cc/GGQdcd 


Y What a Lego man 
looks like as a 
Lego scan 


electromagnetic radiation (usually X-rays) 

penetrates an object, and sensors on the other 
side capture a cross-section of it. These slices are 
then built up to create a 3D model of the object, 
complete with its interior. If this sounds familiar, it 
might be because you've had a CAT scan at some point 
in your life. It's fairly standard medical technology, 
and these days you can control them with just a 


Raspberry Pi. 


T omography is a process where high-energy 


m It uses a turntable to rotate 
the object, with the Pi 
Camera taking a 'reading' of 
the object under the visible 
light beamline Ø 


Emma Osbiston was entrusted by Diamond Light 
Source, a facility housing a synchrotron, with 
creating a way of demonstrating a Pi controlling such 
a device, albeit safely without a particle accelerator 
shooting out beams of radiation. 

“Essentially, I was tasked with developing a 
‘mini-beamline’, using a Raspberry Pi running 

Diamond’s Data 
Acquisition software,” 
reveals Emma. “The most 
significant difference 
between [this] anda real 
tomography beamline 
at Diamond was that 
instead of high-energy 
X-ray light, I was tasked 
to use visible light as 
`% my beamline, which 
meant that instead of 
an expensive, highly 
specialised detector, I was 
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able to just use a Raspberry Pi Camera Module as 
my detector.” 


A light scan 

While a lot of 3D capture rigs use multiple camera 
setups to take numerous photos at once, this setup 
uses a turntable to rotate the object, with the Pi 
Camera Module taking a ‘reading’ (photos) of the 
object under the visible light beamline. Using the 
software, a 3D model is then constructed from 

the data. 

“The idea of the project was to create something 
that could be useful for outreach and explanation 
of Diamond’s beamlines,” explains Emma, “as 
well as showing off GDA - Diamond’s ‘Generic 
Data Acquisition’ software for synchrotrons - by 
demonstrating its flexibility by running it on a 
Raspberry Pi!” 


3D with friends 

A big part of the project was that it would be 
operated using Twitter requests, with users 
tweeting to @DiamondRPi with a number between 
1and 10. A robot arm would then select the sample 
and put it on the scanning turntable. The scan 
would then be sent back to the original user. 

“T would have liked to improve the Twitter 
response of [this project],” Emma admits. “For 
example, providing better-quality images or 
even GIFs, and a progress report from the Pi 
Camera showing the sample being scanned - this 
in particular is something being continued at 
Diamond now!” 

The project was completed to the original 
specifications at least, Emma tells us: *By the 
end of the summer we had a successfully working 
‘beamline’ that filled all of the initial starting goals 
and some more - the robot arm had been intended 
as more of a stretch goal if the project went well, 
but by the end we had that successfully working 
too! Essentially, a user could tweet @DiamondRPi 
with a request, and get scan data back." m 
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» The technical 
project name is: 
Ro3: A Raspberry 
Pi Tomography 
Beamline 
Controlled 
Through Twitter 


» Using a Pi allows 
for the design to 
be reproducible 


» The Twitter 
account, 
&bDiamondhRPi, is 
still active 


» The project was 
created during 
a three-month 
summer placement 


» The Twitter 
and robot arm 
E | components 
A subject is chosen to \ aren't required to 
be scanned via Twitter ) : recreate it 


al 


The Raspberry Pi 
scans the object with 
a Camera Module, 
and creates a 3D 
model of the object 


The robot arm picks up 
the selected model and 
puts it on a turntable 


ETÀ 
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Heverlee Sjoelen 


Raise a glass to Grant Gibson, whose attempt at simplifying a shuffleboard 
game has proven refreshingly rewarding, as David Crookes discovers 


table shuffleboard variant Sjoelen. But if you 
have, then you'll know it has a basic premise - 
to slide wooden pucks into a set of four scoring boxes 
- but some rather complex rules. 
It may seem odd that a game which relies so much 
on hand-eye coordination and keeping score could be 


C hances are you've never heard of the Dutch 


Grant deemed a perfect match for a project commissioned 

Gibson by a beer brand. Yet Grant Gibson is toasting success 
with his refreshing interpretation of Sjoelen, having 

Grant is interested simplified the rules and incorporated a Raspberry Pi to 


in physical builds 


: : serve special prizes to the winners. 
and installations j D. . . 
and he has *Sjoelen's traditional scoring requires lots of 
produced a number addition and multiplication, but our version simply 


of interactive 
games, kiosks, and 
museum exhibits. 


gives players ten pucks and gets them to slide three 
through any one of the four gates within 30 seconds," 
Grant explains. 

As they do this, the Pi (a Model 3B) keeps track of 
how many pucks are sliding through each gate, figures 
how much time the player has left, and displays a 
winning message on a screen. A Logitech HD webcam 


is also used so that bystanders can watch the live A To operate the can dispenser mechanism, replays were used to 
control a set of car door locking actuators from the Pi's GPIO pins 


magpi.cc/DQiGwQ 


m The prototype went out of alignment and 


tasks and get the Pi to communicate with a full- 


started slicing through cans, creating a screen Chromium browser, via JSON, in order to 
] handle the scoring and display tasks in JavaScript. 
h uge frot hy fo untain of beer | *We used infrared (IR) sensors to detect when a 
puck passed through the gate bar to score a point," 
reaction of players as they veer between frustration Grant adds. “Because of the speed of the pucks, 
and success. “It’s a tactile game with a long, we had to poll each of the four IR sensors at over 
interesting history,” Grant says. 100 times per second to ensure that the pucks were 
always detected. Optimising the Python code to run 
Taking the plunge fast enough, whilst also leaving enough processing 
Grant started the project with a few aims in mind: power to run a full-screen web browser and HD 
“I wanted something that could be transported in a webcam, was definitely the biggest software 
small van and assembled by a two-person team, and1 challenge on this project.” 
wanted it to have a vintage look." Inspired by pinball 
tables, he came up with a three-piece unit that could Bottoms up 


be flat- packed for transport, then quickly assembled The Raspberry Pi's GPIO pins are used to trigger 


on site. The Pi 3B proved a perfect component. the dispensing of a can of Heverlee beer to the 

Although Grant has tended to use full-size PCs, he winners. These are stocked inside the machine, 
says the Pi allowed him to reduce software complexity but building the vending mechanism was a major 
and the need for external hardware to control I/O. headache since it needed to be lightweight, 
Indeed, he was able to simply use Python for the I/O compact, and keep the cans cool. 
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Acan dispenser is 
incorporated into the cabinet, 
which has been painted in the 
blue of beer brand Heverlee 


TURNING PINTS WT. 


E 


The display mixes the output of 
the HD webcam with animated 
graphics that keep score 


Grant based the game on a standard 
board from Masters Traditional Games 
and he spent a few lunchtimes playing it 


> Sjoelen is popular 
in Germany, 
Belgium, and the 
Netherlands 


> This version took 
Sjoelen has been undergoing a hipster around 150 hours 


revival of late, making it perfect for bars 
to create 


> The total parts cost 


No off-the-shelf vending unit offered a solution, Nass than £400 


and Grant's initial attempts using stepper motors 
and clear laser-cut acrylic gears proved disastrous. 
* After a dozen successful vends, the prototype 
went out of alignment and started slicing through 
cans, creating a huge frothy fountain of beer. 
Impressive to watch, but not a great mix with 
electronics," Grant laughs. 

Instead, he drew up a final design that was 
laser-cut from poplar plywood. “It uses automotive 
central locking motors to operate a see-saw 
mechanism that serve the cans. A custom Peltier- 
effect heat exchanger, and a couple of salvaged 
PC fans, keep the cans cool inside the machine,” 
reveals Grant. 

“Pd now love to make a lightweight version 
sometime, perhaps with a folding Sjoelen table 
and pop-up scoreboard screen, that could be 
carried by one person,” he adds. We’d certainly 
drink to that. M 


» Alocal furniture 


maker built 
the cabinet 


» Beer is dispensed 


to the winners 
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Raspberry P1-Driven 
Telescope Mount 


Faced with the astronomical costs of a WiFi-accessible telescope mount, Dane 
Gardner reached for an affordable star: the Pi Zero W. David Crookes looks into it 


the open INDI protocol designed for controlling 
astronomical equipment and the open-source 
astronomy software KStars (which graphically 
simulates the night sky and makes for a great 
observation planner), he could also add an 
alternative controller: a gamepad. This allowed for 
a better slew interface. 

“Wireless slew control allows the scope to 
settle out faster after movement, so much so 
that I can track an object manually using the 


with your naked eye and see an assortment of 

stars for free, you'll need to splash some cash 
on a telescope to get a closer look. Dane Gardner has 
found a way of incorporating higher-end features into 
a more affordable scope by making use of the WiFi 
capabilities of a Raspberry Pi Zero W. 

He owns a Celestron NexStar 6 SE, a computerised 

telescope with a six-inch aperture and a fully 
automated mount that contains a database of 40,000 


E ven though you can gaze up at the night sky 


Dane 
Gardner 


Dane is a software 
engineer by day 
and an amateur 
stargazer at night. 
He lives in Seattle, 
where there's 
usually a high 
chance of cloud 
and rain. 


magpi.cc/JpWWff 


celestial objects. It automatically locates and tracks 
objects, making life easier for a stargazer. One thing 
it doesn't have, however, is WiFi, nor does it allow 
Secure Shell access (something no off-the-shelf 
mount has). *The thought of having absolute control 
over the telescope via a Linux command line was just 
too tempting to pass up,” Dane tells us. 


Pi in the sky 
Living in Seattle, a computerised mount is almost 
a necessity. Not only do the bright skies of the city 
make it difficult to manually find objects using an 
astronomy map, the clouds are often quick to roll in. 
Trouble is, WiFi-enabled mounts are expensive - a 
Celestron Evolution costs $500 more than the NexStar 
6 SE - but thankfully the Pi Zero W is available for a 
fraction of that and, just as importantly, it also fits 
perfectly inside the telescope's hand controller. 
Indeed, that is where Dane placed it. He'd already 
spent a couple of months experimenting with a Pi 
Model B, and looking at ways to use an original Pi 
Zero and a USB hub for connecting WiFi and RS-232 
adapters. Once the Pi Zero W was launched, however, 
it presented the perfect solution: “I was really lucky 
that all I had to do was wire up the Pi, configure some 
software, and write some glue scripts to hold it all 
together." Powered by the mount's battery pack, it 
also comes with the bonus of Bluetooth. 


Controlling movement 
This presented a further opportunity. Although Dane 
was happy that he could now make use of the both 
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m The thought of having 


absol 


ute control over 


the telescope via a Linux 
command line was too 
tempting to pass up Ø 


game control 


er,” Dane explains. “I have a great 


image of Jupiter I captured this way before the 


sun had even 
I couldn't do 


set completely. This is something 
before with the corded hand 


controller, which introduces vibrations through 


the cord and 
to control it.’ 
The result 
Dane's needs 
and time sett 


requires me to be very near the scope 


) 


is a telescope mount that better suits 


, incorporating automatic location 
ings by making use of his external IP 


address and NTP when connected to a network. “I 
can run outside, get set up very quickly, and see 
what I want to see before having to break it back 


down and head back inside," he says. 


What's mo 


re, he can also keep both hands in his 


pockets while he controls the scope. "That's a huge 


bonus on tho 


se cold nights of visual observation," 


he reveals. “But I’m still surprised at how this just 
came together so fluidly. I didn’t really experience 
any major problems and none of my projects ever 


go this well.” 


m 


The Pi is set up to allow a 
phone or laptop running 
KStars to remotely control 
the telescope's position 


Despite the integration 
of a Raspberry Pi Zero W, 
the scope mount can still 


be operated normally 


| Mm PROJECT Showcase, ii pr 


Gamepad control was 
a desire rather than a 
necessity, but it means Dane 


can track an object manually 


b 


we — 


The project adds 
WiFi to the 
tracking mount 


It also allows the 
use of a Bluetooth 
gamepad 


The Pi Zero W runs 
Raspbian Stretch 


It connects to the 
hand controller's 
main board 


Open-source 
astronomy software 
KStars is used 


[n 


Although the 8BitDo 
SNES30 Bluetooth 
controller works 
well, s still 
having problems 
with automatic 
reconnects after it 
goes into 

sleep mode 


Dane discovered that 
he could use the Pi 
Zero W to bypass the 
RS-232 chip and go 
pure UART without 
ifting 
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StereoP1 


Powered by a Raspberry Pi Compute Module, this open-source camera board can 
capture stereoscopic 3D photos and videos. Phil King gets double vision 


id you know that since 2014, Raspbian has 
D offered built-in support for stereoscopic 


photography? The only obstacle to making use 
VIRT2REAL 


of it is that standard Raspberry Pi models only have a 


single Camera port. The Pi Compute Module, on the 
other hand, supports the connection of two Camera 


Modules, which is why the Russian virt2real team 


: have used it to power StereoPi - a project that has 

virt2real P Pro) 
taken over three years to develop. 

Based in Russia, the “Starting in the middle of 2015, we did our first 
t have b i " 
jns ave n generation board on Compute Module 1, recalls A Ademo live-streaming video of an aquarium to YouTube; you 
ma i eA virt2real’s Eugene Pomazov. “We understood that can view it in 3D on any phone equipped with a 3D viewer, or 
controlled vehicles onan Oculus Go VR headset 
With realctimevidec we needed not only to control our drones or robots, 
live-streaming but add more autonomous features. The age of AI and 


since 2010. Projects 


computer vision had come. 
include controlling 


Attaching to any Compute Module via its 


a vealesrandis *We tried to find ready-to-use solutions on SODIMM connector, the latest version of the 
bulldozer with the market. But all of them were either expensive StereoPi board features two Camera ports, 
an iPad. 


industrial-level solutions, or crappy-quality toys. [...] ^ positioned at the ideal spacing (65 mm) for 
virt2real.com That's why we decided to create StereoPi. Two cameras stereoscopic photography. 


with fully controlled options, friendly Raspberry Pi 

ecosystem with a lot of ready-to-use examples, and Standard Pi ports 

an inexpensive solution with computing power on It also features standard Pi model connections such 
board which costs about $100-150." as a 40- pin GPIO header; ports for Ethernet, USB, 
and HDMI; and a microSD slot. Eugene says the 
team's favourite addition is a small power switch, 
enabling you to restart the system without having 
to unplug the cable or turn off at the mains. 

With Raspberry Pi at its core, StereoPi works 
with the standard Raspbian OS. Since stereoscopic 
support is already built into the raspistill or 
raspivid commands, as well as the Python 
picamera library, it's ready to use out of the box. 

a, Naturally, you'll need some kind of mounting 
£ plate for the two cameras, to keep them spaced 
i and aligned correctly. The virt2real team have 


< 
= 


created a few mounts for different uses, including 
3D photography (with cameras side by side) and 
panoramas (with wide-angle lenses facing in 
opposite directions). “We plan to share all drawings 
and ready-to-print STL files so anyone can use and 
modify them for their needs,” says Eugene. 


AWM 20624 80C 60V vw 
WAY w 


9 208 vz902 WAY Ww 


0624 80C 60V VW-! 


be rz90c 


pP A Raspberry Pi prom 
Compute Module s a > 
is attached to the 3 4 
SODIMM connector 
on the underside of 
the StereoPi board 


Double the possibilities 


Eugene envisages two main application scopes for 
StereoPi: “The first one is a 3D video live-stream 
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Powered by a Pi Compute Module, 
the board features USB, Ethernet, 
and HDMI ports, plus a 40-pin header 


It even adds a power 
switch to save 
unplugging cables 


Two Pi Camera Modules can be 
connected to the StereoPi board, 
for stereoscopic photography 


to the user. The second is 
computer vision.” 
Stereoscopic video can be 
live-streamed to the internet 
(e.g. YouTube) or viewed 
on a VR headset such as an 
Oculus Go. *You can obtain 90 
frames per second with smaller 
resolutions (like 640x480)," 
reveals Eugene, "or higher 


» StereoPi comes in 
standard and 


. . slim editions 
resolutions at smaller fps (30 with Full HD).” 
The compact and light nature of StereoPi makes » The standard 
it particularly useful for attaching to drones and one measures 
robots. As well as live-streaming video from 90x40x23mm 


them, this is where the computer vision aspect 
comes into play. “Collision avoidance was the first 
idea that came to our mind when we decided to 
create StereoPi,” explains Eugene. “You can use 
OpenCV or ROS [Robot Operating System] and on- A Adepth map generated in ROS - the StereoPi is ideal for 
board computations by means of the Raspberry Pi computer vision systems on robots, to aid collision avoidance 
Compute Module to obtain a depth map or SLAM 


v 


The final product 
will have a 
black PCB 


wa ali dos ane deem eer Miet San Im Caa nm 


v 


It supports v1 
and v2 Pi Camera 


[simultaneous localisation and mapping]. mn Th e com D act an d | j g ht A 

He concludes, “In both live-stream and > Plus an HDMI video 
computer vision cases, we think StereoPi will bea nature of StereoPi makes it capture module 
great tool for learning and experiments.” . . 

If this article has piqued your interest in the particularly useful for attaching 
possibilities of 3D photography, see StereoPi's 
crowdfunding campaign at magpi.cc/JjOTKY. Ui tO d rones an d ro D Ots n| 
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Firefighter 


Monitoring System, .« ~ 


A switched-on high school student is developing a 
device to monitor the vital signs of firefighters. 
Nicola King puts her finger on the pulse 


hen Parisa Khashayar witnessed a firefighter 
W being treated for an injury during a wildfire, 

she began to ask herself how, or even if 
firefighters’ health and well-being was monitored 
while they were out in the field: "Firefighters put 
themselves in danger to keep us safe, but I asked 
myself, what keeps them safe? Besides their fire- 
resistant suit, what other measures are taken to ensure 


Parisa 


. 2 ) 
Khashayar their safety: My research showed that there wasn ta 
lot of high tech equipment available to monitor their 
^ high school health and warn them of dangerous conditions." 
freshman, Parisa Having confirmed with a local fire station that a 
enjoys teacning device to monitor firefighter health would indeed be 
E 
younger children i NR "e 
how to code while useful, Parisa set about designing and building her 
volunteering at her Monitoring System. “I started planning and designing 
local CoderDojo, the device when I was in eighth grade (about a year 
magpi.cc/kGsnNh and a half ago),” she tells us. “I knew some coding, 


but I had to learn how to connect the hardware 
pieces together.” 


Decisive data 

Parisa’s device cleverly takes key measurements 
and compares them to threshold data. “I useda 
microprocessor and four different sensors to collect 


Ui It is very gratifying to design and build and 
code a machine that can perform a task 
and solve a problem Ø 


and measure data about a firefighter’s condition as 
well as their surrounding environment,” she explains. 
*My code takes that information and compares it 
to a preset threshold; if the data does not fit within 
that threshold, it will send a message to the nearby 
command centre through cellular technology." 
P The original Parisa admits there was a lot of fine-tuning required 
prototype was based 
on an Arduino in order to develop her project. “The hardest part of 
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Various sensors capture 
environmental data, as 
well as heart rate 


Amini LCD display 
shows data from 


the sensors 


An Arduino MKR NB 1500 
provides loT cellular connectivity 
to send notifications 


Quick FACTS 


» Sensors monitor 
gas, temperature, 
motion, and 
heart rate 


"Tm injeh ov ; » She plans to turn 
å it into a Pi-based 
wearable device 


> It won joint first 
place for hardware 
at Coolest Projects 
USA 2018 


» Details of Coolest 
Projects 2019 
can be found at 
coolestprojects.org 


A Pi 3 is used for this 
prototype, but the finished 
device will be wearable 


» Parisa hopes to 
study biomedical 
engineering in 


the future 

my first design was definitely coding the heart rate test it out with one of the fire stations nearby who 
sensor and the GSM. The heart rate sensor needed agreed to help test out my prototype." 
a lot of calculations to convert the raw data to an 
actual heart beat and heart rate. The GSM is what! Hot shot 
used to send the notification out.” With this exciting, practical, and potentially 

Undeterred, Parisa forged ahead with her design, life-saving innovation, Parisa has proved that 
culminating in the opportunity to showcase her coding is her forte, and is something that she 
work at Coolest Projects USA in 2018, an exciting thoroughly enjoys, explaining, “It is a way to 
technology fair for young people. *We talked express myself and [of] connecting myself to the 
about problems we encountered with our projects outside world... It is very gratifying to design and 
and exchanged ideas... One of the best parts build and code a machine that can perform a task W Parisa talking about 
was meeting the judges; they were incredibly and solve a problem.” bolso EE 
encouraging and excited to find out about So, what does the future hold for this very smart 
everyone's work," she says. student? “I just started high school this year with a 

Having used an Arduino Uno for her original full schedule that’s kept me busy, so I haven't had 
prototype, Parisa is now converting the project to much time to get back to the drawing board. I will 
Raspberry Pi so that the size of the device can be always be looking for new ways to solve problems 
reduced. Introduced to the Pi at Coolest Projects, but, for now, I’m mostly focused on improving my 
she explains that she saw how “powerful, yet Firefighter Monitoring System before I move on 
simple, it is to program... I plan to get everything to another project," says Parisa, who is clearly 
into a PCB small enough to fit into a wearable, and destined for great things. Watch this space! M 
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he Raspberry Pi community is huge. 
It’s one of the most amazing parts 
of everything that makes up the 
Raspberry Pi - a global collection of people 
excited to show off what you can do 
with the Raspberry Pi, and even help 
others with their projects at Raspberry 
Jams, Code Clubs, CoderDojos, and 
other gatherings! 


We want to celebrate the community 


dur 


ing March with our #MonthOfMaking 


event: throughout the month, work on a 


pro 
soc 


ject and share your works-in- progress to 


ial media. That's it! Whether you're new 


to making or have a Raspberry Pi make you 
breakfast, we want to see what you can do 


and 


flood the internet with creative uses for 


physical electronics. 


for 


eed some ideas of where to start? Read on 
some inspiration... 


FEATURE | MägPi MEE 


Tools for the Job 


To make something cool, you might need some tools 


[ Electronics | Wood and metal l 3D printing and plastics 


Circuits can connect your 
Raspberry Pi and microcontrollers 
to lights, buttons, speakers, or 
even a full-on robot. Here are 


Old-school building methods can 
sometimes require some serious 
hardware. If you’re new to this, 
ask an experienced adult for 


Don’t try this at home... unless 
you have an expensive 3D printer 
or laser cutter. If you don’t, you 
can find designs for 3D printers 


I l 
l l 
1 1 
1 1 
1 i} 
[| l 
l l 
1 i} 
1 I 
l l 
l l 
some of the tools of the trade. | some tips. | on websites such as Thingiverse 
i | (thingiverse.com) and print them 
» Wire |o» Saw | on3D Hubs (3dhubs.com). 
1 1 
> Jumper cables i > Welder i Digtene ose 2 
1 I {~ 
1 1 
> Breadboard | > Vice ; 
> LEDs | > Drill 
l l 
> Buttons |» Glue i 
i i 
> Motors | > Sander i 
1 1 
1 1 
> Soldering iron He Jigsaw 
1 1 


> Measuring tools 


Adafruit 
adafruit.com 

Jeader in ama 
ents 


zing 
A global 
maker compon 
and hardware 


#MonthofMaking | magpicc | 31 


MéigPi 


maker starters 


New to making? Here are some ideas to help you get started 


veryone needs to start somewhere. 

All the most amazing makers in the 

world at some point had to figure out 
‘Hello World’, how to control an LED with 
code, and how to build. 

Don’t be afraid to share your first forays 

into the world of making. The rest of us are 
here to help and appreciate your work! To give 
you that first boost, here are some beginner 
projects that you might find useful. 


Whoopi Cushion 
What's the point of making if you're not having fun doing it? 
We particularly love this project as it’s very cheap to make, 
and includes some real DIY skills to create a big button for 
the device. 


E 
| í | 
Zz “vy 
n a ‘esas 
) Beginner Wearables 


Sushi Cards 


This is a fun wearable project that uses simple 
circuits and pre-designed parts to create 
some fun-looking clothing items. Perfect for 
showing off your new-found making skills! 


Countdown Timer 
This simple project shows you how to use a Sense HAT - an 
environmental sensor with a simple display add-on for the 
Pi - as a countdown timer. You can probably also turn it into a 
stop-watch as well. 


Am 
b. 
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Learning resources from Raspberry Pi 


Part of the Raspberry Pi Foundation's mission is to bring free 
computing education to everyone, and the Raspberry Pi projects 
site has programming, making, and other computer-based tutorials 
for you to learn from. You can find it at rpf.io/projects, where you'll 
even find more making ideas while perusing tutorials on ‘Physical 
computing with Python’ (magpi.cc/2mjGMJZ) or ‘Getting started 
with picamera’ (magpi.cc/QrMnng). 


makers 


Here are some folks to follow on YouTube! 


Estefannie 
Explains It All 
Software engineer and maker 
of fun projects 


Junie 

Genius 

Science, making, and 
everything in between 


PRESS START TO PLA 


- -PIACE > Jabrils 


Maker who specialises in Al 


Blitz 

City DIY 

A maker who dabbles a little bit 
more in the art side 


Media Server! 


Tinkernut 
Making, mending, and hacking 


MéigPi 


maker hobbyists 


If this isn't your first maker rodeo, here are some fun projects to try out 


very day, we see yet another incredible 


Choose project or make that someone has done. 
I It's almost impossible to run out of ideas, 
a theme! it seems — but sometimes we need a bit of 


inspiration. Here are some projects to get your 


Not sure where brain cells firing. 


to start? Maybe 
picking a theme 
for your build(s) 


will help! 

Robots 
ui 

- ¥ Amazon Echo = 
Controlled Curtains 


Raspberry Pi Drum Kit 
This project is the ultimate in DIY, and very cheap 
to make as well! It uses a load of PVC pipes, paper 
plates, wire, and lots of other bits that you can find 
in a DIY store. Oh, and it also requires two acorn 
nuts. It's programmed in Scratch, making it very 
accessible to young makers. 


AI and voice control is widely accessible on 
Raspberry Pi, thanks to Amazon's Alexa, Google's 
ATY, and even Microsoft's Cortana. This project 
marries it with some home automation to open and 
close curtains in your house. You can adapt it to 
control other automated devices, such as lights or 
a garage door. 


Home media 


Home automation 


DiddyBorg v2 
How about building a bigger 
robot? The DiddyBorg v2 is 
one of our favourite robot kits, 
and you can customise it very 
heavily to do some amazing 
automated things. The best part 
is: all the parts are top-quality 
and easily transferable to even 
bigger and better robots! 


Home office 


Photo and video 


Magic 
Mirror 


This classic project is almost a rite of passage 

for Raspberry Pi owners. It’s a lot simpler than 

it sounds, as well, thanks to Michael Teeuw’s 
excellent software. We did a full big build of this in 
issue 54 of The MagPi (magpi.cc/54), and you can 
now find loads of different features to add to this 
kind of project. 


ote 


Boomy Pi Airplay Boombox =@ 


New Guides 


La Ds 
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MéigPi 


exper 


t makers 


Feel like a true challenge? Then get your arc welder ready... 


magpi.cc 


veryone likes a monster build. Something 

impressive. If you're the kind of maker who 

builds fire-breathing dragon vans in their 
sleep, then here are some awesome challenges 
that you might be up to. 


Arcade cabinet 
Sure, you can use a kit to make a little box that 
sits on your counter, but to build a full-on arcade 
cabinet from scratch, complete with working lights 
and art and everything, now that takes some time 
and skill. We especially like this version made by I 
Like To Make Stuff. 


#MonthofMaking 


4-Bot 
Robots aren’t all just the little drivable kits you can 
buy - there are also robot arms, bipedal robots, and 
other kind of walker bots. We quite like the 4-Bot 
here: it's a robot you can play a game of Connect 4 
with. It uses computer vision to see how you’ve 
played and calculates its next move. We’ve also 
seen chess-playing robot hands. So as long as you 
can code it, you can make it. 


Underwater drone/ROV 
Whenever you mix water and electronics, you’re 
always going to have a tough time. The true trick 
with a submersible ROV is to keep the electronics 
dry, while still being able to control it remotely. 
Oh, and did we mention the balancing issues with 
keeping something underwater? It’s quite a precise 
operation, which makes it great for a big challenge. 


Disco Ball Motion S Dimmer Switch Hall Light Lounge Lamp 


Smart home 
What if you could control your own home through 
a Raspberry Pi? We've seen a few people attempt 
it with varying success. Mozilla's Project Things 
has a good post on how you can use its tech to 
completely automate your home - give it a look! 
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DIY Games 
Console 


QZOGEMHAGU 3 SEDI JO SoOUO QOZ 


200 pages of 


THE Official 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 4 


Amazing hacking and making projects 
from the makers of MdgPi magazine 


Inside: 
0 How to get involved with the Pi community 
@ The most inspirational community projects 
@ Essential tutorials, guides, and ideas 


@ Expert reviews and buying advice 


i le e 
Gp magpi.cc/store 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the GET IT ON 
€ App Store f» Google Play 
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Mike 
Tyka 


Mike works with 
artificial neural 
networks as an 
artistic medium and 
tool. He created 
some of the first 
large-scale artworks 
using Iterative 
DeepDream and 
collaborated with 
Refik Anadol to 
create pioneering 
immersive projection 
installations 

using Generative 
Adversarial 
Networks called 
Archive Dreaming. 
Mike currently works 
on machine learning 
at Google in Seattle. 


miketyka.com 


| You'll Need 


» Raspberry Pi 3B 
/ 3B* 


» Coral USB 
Accelerator ($74.99) 


» Raspberry Pi 
Camera Module 


» 8GB microSD card 


» Raspbian Stretch 
with Desktop image 


» Breadboard 


» 5 x Push-button 
Switches 


» 10 x Jumper wires 
(male to female) 


> 9 x Short jumper 
wires (male 
to male) 


> 4 x Resistors (330 Q) 
> 4x LEDs 


Build a Teachable 
Machine with 
Google s Edge TPU 


Use the Coral USB Accelerator and Raspberry Pi 
Camera to build a device that can be taught to 
recognise objects. By Lucy Hattersley 


Al capabilities into any Raspberry Pi project. 

The accelerator is built around Google’s Edge 
TPU chip, an ASIC that greatly speeds up neural 
network performance on-device. 

When combined with the Raspberry Pi and 
Raspberry Pi Camera, you have a complete system 
that’s perfect for executing complex computer 
vision tasks like object recognition. Since the 
Accelerator operates locally, you do not need to 
connect to a cloud service or share secure data over 
the internet. It also runs with less latency than a 
cloud connection, performing object detection in 
near real time. 

Using the Raspberry Pi Camera Module, all 
Raspberry Pi boards can easily gain photographic 
functionality. And with its built-in GPIO pins, 
you can prototype circuits and even integrate 
the Raspberry Pi into projects and industrial 
environments. Throw a USB Accelerator into the 


C oral's new USB Accelerator lets you to build 


A The USB Accelerator attached to a Raspberry Pi 


40 | magpicc | Build a Teachable Machine with Google's Edge TPU 


| coral.withgoogle.com 


mix and you have a capable AI device, ready to take 
on all kinds of tasks. 

In this tutorial we're going to build a Teachable 
Machine. This project was designed by Google's 
Mike Tyka. 

The Teachable Machine learns to identify 
objects held up in front of it. These objects can be 
anything: keys, fruit, chess pieces, or even fingers 
or faces. 

The user holds up items in front of the Raspberry 
Pi Camera Module and presses a button on the 
Teachable Machine. The device then remembers 
the object being held up - if it sees it again, it will 
light up the corresponding LED. 

The Teachable Machine is a great example of 
how to add a layer of machine learning technology 
Sparkle to your projects without having to train a 
whole network from scratch. 

The Teachable Machine can distinguish objects 
quickly and effectively (even from different 
orientations). This sort of project wasn't possible 
even a few years ago on a powerful computer with 
an expensive graphics card. And now we can add it 
to a small single-board Raspberry Pi computer. 


Start with Raspbian 

Start by flashing a fresh installation of 
Raspbian Stretch with Desktop to a microSD 
card (magpi.cc/quickstart). 

Set up your Pi with the Raspberry Pi Camera 
Module attached to the camera socket via a 15-way 
ribbon cable and insert the microSD card. Add 
power to start up the Raspberry Pi. 


A The USB Accelerator enables a Raspberry Pi to 
perform Al tasks in real-time 


Set up the camera 
When the Raspbian OS boots, click the 
Raspberry Pi menu icon in the top-left and choose 
Preferences > Raspberry Pi Configuration. 
Click Interfaces and set Camera to Enabled 
and click OK. A ‘Reboot needed’ alert will appear; 
click Yes. 
Open a Terminal window (CTRL+ALT+T) and 
take a test shot and open it: 


raspistill -v -o test.jpg 
xdg-open /home/pi/test. jpg 


Set up USB Accelerator 

Make sure the USB Accelerator device is 
not connected while you set it up (disconnect the 
device if you plugged it in). Open a Terminal and 
enter these commands to download and install 
the software: 


wget http://storage.googleapis.com/cloud- 
iot-edge-pretrained-models/edgetpu api. 
tar.gz 

tar xzf edgetpu api.tar.gz 

cd python-tflite-source 

bash ./install.sh 


During the installation, it will say: ‘Would you like 
to enable the maximum operating frequency? 
Answer ‘n’ for now. You can enable it later if you 
want to increase the performance. 


Test USB Accelerator 
Now plug in the USB Accelerator using the 
supplied USB Type-A to USB Type-C cable. Your 
USB Accelerator is now set up. 
See Coral’s ‘Get started with the USB 
Accelerator’ document for more information 
on setting up and testing: g.co/coral/setup. 
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Place a learnt object back in front of the Raspberry Pi Camera 
Module and the corresponding LED will light up when it is detected 


Push one of the buttons and the Teachable Machine 


will take note of what it is seeing in the Raspberry Pi 
Camera Module and light up an LED 


Download a model 

Let's take a look at the included demo code. 
The classify capture.py script works with the 
Raspberry Pi Camera Module to perform live image 
classification of objects around us. 

What's needed is a model trained to detect some 

commonplace objects. Download this MobileNet 
model trained to recognise 1000 objects: 


wget -P test data/ https://storage. 
googleapis.com/cloud-iot-edge-pretrained- 
models/canned models/mobilenet v2 1.0 224. 
quant edgetpu.tflite 


Careful! 


The USB 
Accelerator 
can become 
hot during use. 
Avoid touching 
it while the 
project is 
running. 
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Top Tip 


à 


How it works: transfer learning 


The Teachable Machine uses an approach called ‘transfer learning’ In this 
technique, makers start with an already trained model, and customise it for the 


task in hand. 


The Teachable Machine uses a headless MobileNet model, in which the 
last layer (which makes the final decision on the 1000 training classes) has 
been removed, exposing the output vector of the layer before. The Teachable 
Machine treats this output vector as an embedding vector for a given image. 

More info on the details of the algorithm and transfer learning can be found 
here: magpi.cc/LeKzkc. 


TopTip è 


Get models 


Google has a 
selection of 
models available 
on its Coral 
website: 
magpi.cc/OmyrGC 


Now get the corresponding labels: 


wget -P test data/ http://storage. 
googleapis.com/cloud-iot-edge-pretrained- 
models/canned models/imagenet labels.txt 


This model and label set can be found (along 
with many other models) on the Coral website 
(coral.withgoogle.com). 


Live camera detection 

We now have a pre-trained model for 1000 
objects and a corresponding label set, plus a live 
capture camera script. Put all three together and 
you can run an object-detecting camera. 


python3 demo/classify capture.py --model 
test data/mobilenet v2 1.0 224 quant 
edgetpu.tflite --label test data/imagenet 
labels.txt 


Move the Raspberry Pi Camera Module around the 
room and the preview window will identify the 
objects around you: laptop, mouse, soda can, and 
So on. 

The classify capture.py program uses 
two options: 


--model 
--label 


And each one links to the model and corresponding 
labels downloaded in Step 5. 

This is a TensorFlow Lite model (hence the 
.tflite extension) that has been pre-trained to 
detect 1000 objects. Typically, training will have 
taken place on a much faster computer, or cloud 


42 | magpicc | Build a Teachable Machine with Google's Edge TPU 


service, using thousands of train and test images. 
During training, the model gradually gets better 
at matching the images to the label list. When it's 
good enough, we use it on the Raspberry Pi. 


07 The Teachable Machine 
It's time to bring the technology together 
to build something. We're going to build the 
Teachable Machine project. Like our Classify 
Capture demo, it scans for objects using the 
Raspberry Pi Camera Module. However, the 
Teachable Machine learns to detect the objects 
you are holding up in front of it. 
Start by installing the additional dependencies: 


sudo apt-get install libgstreamer1.0-0 
gstreamer1.@-tools gstreamer1.0- 
plugins-base gstreamer1.0-plugins-good 
gstreamer1.0-plugins-bad gstreamer1.0- 
plugins-ugly python3-gst-1.0 python3-gi 


Now add bcm2835-v4l12 to the end of /etc/modules: 


sudo cat bcm2835-v412 >> /etc/modules 


Set up the Teachable Machine 

Turn off the Raspberry Pi with this 
Terminal command (or choose Menu » Shutdown 
and click Shutdown): 


sudo shutdown -h now 


Remove the power from the Raspberry Pi and 
set up the Teachable Machine breadboard 
with the switches and LEDs as shown in the 
circuit diagram (Figure 1). We find it best to lay 
the Raspberry Pi Camera Module flat on a surface 
so it is pointing upwards. 

Reattach the power once the circuit is set up. 


Install the code 

Open the Chromium browser and visit 
our GitHub page (magpi.cc/github79).Download 
the teachable rpi3.tgz file from there to your 
home folder. Open a Terminal window and extract 
the code: 


tar xvzf teachable rpi3.tgz 
cd /home/pi/teachable/ 
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embedding.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 


© magpi.cc/github79 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 


Detection Engine used for detection tasks. 
from collections import Counter 

from collections import defaultdict 

from edgetpu.basic.basic_engine import BasicEngine 
import numpy as np 

from PIL import Image 


class EmbeddingEngine(BasicEngine): 
"""Obtains embedding from headless mobilenets.""" 
def init (self, model path): 
"""Creates a EmbeddingEngine with given model. 
Args: 
model path: Path to TF-Lite Flatbuffer file. 
BasicEngine. init (self, model path) 
output tensors sizes = self.get all output 
tensors sizes() 
if output tensors sizes.size !- 1: 
raise ValueError( 
('Model should have only 1 output tensor' 
"This model has ().'.format( 
output tensors sizes.size))) 


def DetectWithImage(self, img): 
"""Calculates embedding from an image. 
Args: 
img: PIL image object. 
Returns: 
Embedding vector as np.float32 
input tensor shape = self.get input tensor 
shape() 
if (input tensor shape.size != 4 or 
input tensor shape[3] !- 3 or 
input tensor shape[0] !- 1): 
raise RuntimeError( 

'Invalid input tensor shape! 
'Expected: [1, width, height, 3]') 
required image size - (input tensor shape[1], 

input tensor shape[2]) 
with img.resize(required image size, 
Image.NEAREST) as resized: 
input tensor - np.asarray(resized).flatten() 
# Run model on accelerator 
return self.RunInference(input tensor)[1] 


048. 
049. 
050. 
051. 
052. 
053. 
054. 
055. 
056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
071. 
072. 
073. 
074. 
075. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 
087. 
088. 
089. 
090. 
091. 
092. 
093. 
094. 


class kNNEmbeddingEngine(EmbeddingEngine): 
"""Extends embedding engine to also provide 
kNearest Neighbor detection. This class 
maintains an in-memory store of embeddings and 
provides functions to query with a new query 
embedding and find nearest neighbors. 


def — init (self, model path, kNN=3): 
"""Creates a kNNEmbeddingEngine with given model 
Args: 
model path: path to TF-Lite Flatbuffer file. 
kNN: how many nearest neighbors to consider. 
EmbeddingEngine. init__(self, model path) 
self.clear() 
self. kNN - kNN 


def clear(self): 
"""Forgets all stored embeddings. 
self. labels - [] 
self. embedding map - defaultdict(list) 
self. embeddings - None 


def addEmbedding(self, emb, label): 
"""Add an embedding vector to the store. 
# Normalize the vector 
normal = emb/np.sqrt((emb**2).sum()) 
# Add to store, under "label" 
self. embedding map[label].append(normal) 


# Expand labelled blocks of embeddings for when 
# we have less than kNN examples. Otherwise 
# blocks that have more examples unfairly win. 
emb blocks - [] 
self. labels - [] 
for label, embeds in self. embedding map.items(): 
emb block - np.stack(embeds) 
if emb block.shape[0] < self. kNN: 
pads = [(0,self. kNN - emb block.shape[9]), 
(6,0)] 
emb block - np.pad(emb block, pads, 
mode-"reflect") 
emb blocks.append(emb block) 
self. labels.extend([label]*emb block.shape[9]) 
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095. self. embeddings - np.concatenate(emb blocks, 
096. axis=@) 
097. 
098. def kNNEmbedding(self, query emb): 
099. """Returns the self. kNN nearest neighbors to a 
100. query embedding.""" 
101. 
102. it If we have nothing stored, the answer is None 
103. if self. embeddings is None: return None 
104. 
105. it Normalize query embedding 
106. norm = np.sqrt((query emb**2).sum()) 
107. query emb - query emb/norm 
108. 
109. it We want a cosine distance from query to each 
110. it stored embedding. A matrix multiplication can 
111. # do this in one step, resulting in a vector of 
112. it distances. 
113. dists - np.matmul(self. embeddings, query emb) 
114. 
115. it If we have less than self. kNN distances we 
116. it can only return that many. 
117. kNN - min(len(dists), self. kNN) 
118. 
119. it Get the N smallest distances. 
- p "Y The USB 
120. n argmax = np.argpartition(dists, -kNN)[-kNN:] Accelerator is 
121. part of Coral's 
line of Al-related 
122. # Get the corresponding labels associated with products 
123. # each distance. 
124. labels = [self. labels[i] for i in n_argmax] 
125. 
126. # Return the most common label over all 
127. # self. kNN nearest neighbors. 
128. most_common_label = Counter(labels) 
129. return most common label.most common(1)[0][0] 
130. 
131. def exampleCount(self): 
132. """Returns the size of the embedding store.""" 
133. return sum(len(v) for v in 
134. self. embedding map.values()) 
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All the code needed to run the Teachable Machine 
is found (and is run from) this directory. The 
embedding.py code listing demonstrates the 
most critical parts. Enter this code to test out 

the circuit: 


sudo python3 teachable.py --testui 


The LEDs will flash to indicate that the circuit is 
working. Press the buttons and the Terminal will 
display which button is working (between 0 and 4). 
Press CTRL+C to interrupt the program. 


Run the Teachable Machine 
Now it’s time to run our Teachable Machine 
and see what it is capable of doing. Enter: 


sh run.sh 


V The assembled Teachable Machine project. When a button is 
pressed, the device observes an object in front of the camera; 
then it recognises the same object and lights up an LED 


The Teachable Machine will initialise its model 
and start running. The LED in the USB Accelerator 
hould be glowing and the Terminal will display a 
rame rate (typically around 30 fps). Hold an item 
such as a piece of fruit or a computer mouse) 
bove the camera and press one of the buttons 
hat's paired with an LED (the LED will light up 
next to the button). Let go of the button and move 
the item away. 

Now, when you bring the item back in front 
of the camera, the corresponding LED will light 
up. Keep bringing different items in front of the 
camera and pressing different buttons to train 
the machine to detect each one. It's helpful to 
dedicate one button to just background (with no 
item held). 

If the Teachable Machine seems a little 
unsure, you can always press the button again to 
retrain it. It is good practice to press the button 
multiple times and rotate the object slightly with 
each press. 

Have fun playing around with different items. 
Press the fifth button (reset) to clear all the items 
from memory. fl 


— mn 


com 
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TopTip è 


Laser-cut 


See the file 
rpi3plate.dxf 

on our GitHub 

if you want to 
laser-cut a stable 
platform for the 
components. 
magpi.cc/github 
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Car Spy P1 


Who's that parked on the driveway? 
Find out automatically using ANPR 


Evans 


PJ is a writer, trainer, utomatic number-plate recognition (ANPR) 

and freelance is becoming more and more commonplace. The Pi Camera Module is 
software engineer. h lisi 1 fth li h + 

His son can't Once the exclusive realm of the police, the protected from the elements by 
‘borrow’ the car as technology used to accurately read car number- a clear cover and rubber O-ring 
easily any more. plates can now be found in supermarket and 

@mrpjevans airport car parks. It wasn’t long ago that this 


technology was extremely expensive to purchase 
and implement. Now, even the Raspberry Pi 

has the ability to read number-plates with high 
accuracy using the Pi Camera Module and open- 
source software. Let’s demonstrate what’s possible 
by building a system to detect and alert when a car 
comes onto the driveway. 


Pick a spot 

First things first: where are we going to put 
it? Although this project has lots of applications, 
we’re going to see who’s home (or not) by 
reading number-plates of cars coming and going 
on a driveway. This means the Raspberry Pi is 
probably going to live outside; therefore, many 
environmental constraints come into place. You'll 
need USB 5V power to the Pi and a mounting 
position suitable for reading plates, although the 
software is surprisingly tolerant of angles and 
heights, so don't worry too much if you can't get it 
perfectly aligned. 


Get an enclosure 
| You'll Need As our Pi is going to live outside (unless 
you have a well-placed window), you'll need an 


» Pi Camera Module appropriate enclosure. For a proper build, get an 

magpi.cc/camera IP67 waterproof case (e.g. magpi.cc/epzGcX). 
suitable GUidoor We're opting for homemade, and are using 

enclosure, e.g. a Raspberry Pi 3 A* with the RainBerry - a 

magpi.cc/hOVWBP 3D- printable case that, once you add some rubber This case is water= 
»iBushoveraccount seals, provides adequate protection. Make sure resistant with rubber 


(optional) whatever you choose has a hole for the camera. seals protecting the gaps 
pushover.net 
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Prepare your Pi 

As we don’t need a graphical user interface, 
Raspbian Stretch Lite is our operating system of 
choice. Any Pican handle this task, although if 
you want the fastest image processing possible, 
you probably want to avoid the Zero models 
and get a nice, zippy Model 3B or 3B+. Get your 
operating system set up, make sure you’ve done 
the necessary sudo apt update && sudo apt -y 
upgrade and have configured WiFi if you’re not 
using Ethernet. Finally, make sure your Pi Camera 
Module is connected and enabled. You can check 
this by running sudo raspi-config and looking 
under ‘Interfacing Options’. 


Install openALPR 

Thankfully, we don’t need to be experts 
in machine learning and image processing to 
implement ANPR. An open-source project, 
openALPR provides fast and accurate processing 
just from a camera image. ‘ALPR’ is nota 
mistake: this US project is ‘Automatic License 
Plate Recognition’. Thanks to APT, installation 
is straightforward. At the command line, enter 
the following: 


sudo apt install openalpr openalpr-daemon 
openalpr-utils libopenalpr-dev 


This may take a while, as many supporting 
packages need to be installed, such as Tesseract, 
an open-source optical character recognition 
(OCR) tool. This, coupled with code that identifies 
a number- plate, is what works the magic. 


WW Protect your Raspberry Pi 
with a waterproof case 
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daos c EV, 
PUSHOVER now 


Driveway 
P256FWL has arrived 


es SERO 


A When a car arrives or 
leaves our driveway, 
we receive an alert 
in seconds 


Time for a test 

Once installed, you'll be unceremoniously 
dropped back to the command prompt. OpenALPR 
has installed a command-line tool to make testing 
its capabilities easier and they have also kindly 
provided a sample image. On the command line, 


enter the following: 


cd 
wget http: //plates.openalpr.com/ea7the.jpg 


This is a sample USA plate image and a tough 
one too. Wget grabs the file from the web and 
places it in your home directory. Let's see if we can 
recognise it: 


alpr -c us ea7the.jpg 
All being well, you'll see a report on screen. The 


most likely *match' should be the same as the file 
name: EA7THE. 


Install Python libraries 

We can use openALPR in Python, too. First, 
install the libraries using pip. If you don't have pip 
installed, run: 


sudo apt install python-pip 
To install the libraries: 


pip install openalpr picamera python- 
pushover 


Now test everything is working by running 
Python and enter the following code line by line at 
the >>> prompt: 


import json 
from openalpr import Alpr 


alpr = Alpr("us", "/etc/openalpr/openalpr.conf", "/usr/share/ 
openalpr/runtime data") 

results - alpr.recognize file("/home/pi/ea7the.jpg") 
print(json.dumps(results, indent-4)) 

alpr.unload() 
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A Our target. The software 
does a great job of 
recognising number- 
plates from different 
heights and angles 


If you’ve not seen JSON-formatted text before, 
this might seem a bit much, but you should 
see the correct plate number returned as the 
first result. 


07 Get a Pushover token 
So that we can get an alert when a car 

arrives or leaves, we're using old favourite 
Pushover (pushover.net), which makes sending 
notifications to mobile phones a breeze. There's 
a free trial, after which it's a flat fee of $4.99 per 
device, with no subscription or limits. Once logged 
in, go to 'Your Applications! and make a note of 
your User Key. Then click ‘Create an Application/ 
API Token’. Call it ‘ANPR’, leave all the other fields 
blank, and click ‘Create Application’. Now make a 
note of the API Token; you'll need this and the User 
Key for your code. 


Typing time 

Now you have everything you need to create 
your ANPR application. Enter the code listing 
shown here or download it from magpi.cc/VEsaCg. 
Save it as anpr.py in your home directory. Edit 
the file and enter your User and App tokens where 
prompted. Save the file, then test by entering: 


python anpr.py 


The code makes use of the Pi Camera Module 
and openALPR in tandem. Every five seconds, 
the camera takes a picture which is passed to 
openALPR for analysis. If a licence plate is found, 
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we get the number. If there has been a change, an 
alert is sent to Pushover, which is then forwarded 
to any registered mobile devices. 


Make your list 

If you want to have more friendly names 
rather than just the plate number, try adding a 
Python dictionary just after the import statements, 
like this: 


lookup - ( 
"ABC123": "Steve McQueen", 
"ZXY123": "Lewis Hamilton" 
} 


Then change all instances of number, plate in 
the alert text as follows: 


lookup[number_plate] 
Now you’ll get a friendly name instead. See 


if you can handle what happens if the plate 
isn’t recognised. 


Run on boot 

A key part of any ‘hands-free’ Raspberry Pi 
installation is ensuring that in the event of a power 
failure, the required services start up again. There 
are many ways of doing this; we’re going use one of 
the simpler methods. 


sudo nano /etc/rc.local 


Find the final line, exit @ and enter the 
following on the line above: 


#Start ANPR Monitoring 
/usr/bin/python /home/pi/anpr.py 


Press CTRL+X then Y to save the file. Finally, 
run the earlier pip command again, using sudo this 
time to install the libraries for the root user: 


sudo pip install openalpr picamera 
python-pushover 


On reboot, the code will start up and run in 
the background. 
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DOWNLOAD 
anpr.py THE FULL CODE: 


» Language: Python 3 e magpi.cc/VEsaCg 


001. from openalpr import Alpr 034. pushover.Client( 
002. from picamera import PiCamera PUSHOVER USER KEY).send message( 
003. from time import sleep 035. last seen + " left", 
004. import pushover 036. title-"Driveway") 
005. 037. 
006. # Pushover settings 038. last seen - None 
007. PUSHOVER USER KEY = "«REPLACE WITH USER KEY>" 039. 
008. PUSHOVER APP TOKEN = "«REPLACE WITH APP TOKEN»" 040. else: 
009. 041. number plate - 
010. # 'gb' means we want to recognise UK plates, many analysis[ results ][0][ piste ] 

others are available 042. print('Number plate detected: ' + 
011. alpr - Alpr("gb", "/etc/openalpr/openalpr.conf", number plate) 
012. "/usr/share/openalpr/runtime data") 043. 
013. camera - PiCamera() 044. it Has there been a change? 
014. pushover.init(PUSHOVER APP TOKEN) 045. if last seen is None: 
015. last seen - None 046. pushover.Client( 
016. PUSHOVER USER KEY).send message( 
017. try: 047. number plate + '" has arrived", 
018. # Let's loop forever: title-"Driveway") 
019. while True: 048. elif number plate !- last seen: 
020. 049. pushover.Client( 
021. it Take a photo PUSHOVER USER KEY).send message( 
022. print('Taking a photo') 050. number plate + " arrived and " 
023. camera.capture( ' /home/pi/latest.jpg') + last seen + " left", 
024. 051. title-"Driveway") 
025. # Ask OpenALPR what it thinks 052. 
026. analysis - alpr.recognize file( 053. last seen - number plate 

" /home/pi/latest.jpg") 054. 
027. 055. # Wait for five seconds 
028. it If no results, no car! 056. sleep(5) 
029. if len(analysis['results']) -- e: 057. 
03e. print('No number plate detected') 058. except KeyboardInterrupt: 
031. 059. print('Shutting down') 
032. # Has a car left? 060. alpr.unload() 
033. if last seen is not None: 061. 


Add logging and curfews 

One use of this installation is to track the Make it your own 
times cars come and go. This can be especially As ever, it's over to you. Now you have 
useful for young drivers who have curfew the ability to track and record registration plates, 
restrictions on their insurance. See if you can there are many different applications for you to 
augment the code to check whether a registration explore. Since all the analysis of the image is done 
plate has not been seen after a certain time. For locally, no internet connection is required for the 
example, if your younger family members have system to work. Is there someone ‘borrowing’ 
such a restriction, send them an alert to their your parking space at work? Catch 'em in the act! 
phone if their car isn't in the driveway 30 minutes Why not take your Car Spy Pi on the road? It could 
beforehand. You might save them an insurance record every vehicle you encounter, which may 
premium increase! Also, why not log all the be useful should something untoward happen. 
comings and goings to a file? A bit of data analysis Combine a Raspberry Pi Zero with a ZeroView 
might help reduce car usage or fuel costs. (magpi.cc/eBnYrZ) and you're all set. M 
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Mark 
Vanstone 


Educational 
software author 
from the nineties, 
author of the 
ArcVenture series, 
disappeared into 
the corporate 
software wasteland. 
Rescued by the 
Raspberry Pi! 


magpi.cc/YiZnxL 


@mindexplorers 


| You'll Need 


» Raspbian Jessie or 
newer 


» Tiled (free map 
editor) 
mapeditor.org 


> An image 
manipulation 
program such as 
GIMP, or images 
available from 
magpi.cc/fPBrhM 


» The latest version of 
Pygame Zero (1.2) 


Code an 1sometric 
adventure game: 
AmazeBalls 


Pygame Zero in 3D. Let's make the map bigger in part 


two of this three-part tutorial 


Pygame Zero to create a 3D isometric game, we 

will start from where we left off in the last part 
and look at ways to make our 3D area larger and 
easier to edit. This will mean using a map editor 
called Tiled, which is free to download and use, 
to make your own 3D maps. We'll learn how to 
create a simple map and export it from Tiled ina 
data format called JSON. We will then import it 
into our game and code our draw function to scroll 
around the map area when the player moves. Lots 
to do, so let's get started. 


[ n this second part of our tutorial on using 


Tools for the job 

In the previous part of this tutorial, we 
made our map data by writing a two-dimensional 
ist of zeroes and ones which represented either a 
loor block or a wall block. The player was able to 
move onto any block that was a zero in the data. 
This time we are going to get a map-editing app 
to do the work for us instead of typing the data 
in. First, we need to get Tiled installed. You can 
ind the Tiled homepage at mapeditor.org, where 
options are given to support the developer if you 
ike what they are creating. 


Getting Tiled 

Tiled can be used on many different 
systems, including PCs and Mac computers. Also, 
more importantly for us, it works really well on 
Raspbian and Raspberry Pi. It's also super-easy to 
install. All you need to do is open up a Terminal 
window, then make sure you're online and are 
up-to-date by typing sudo apt-get update. You 
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may need to type sudo apt-get upgrade too, 
depending on how long you've left your Pi without 
updates. When those have run, just type sudo apt- 
get install tiled, hit RETURN, and you should 
see Tiled being installed. When it's done, a new 
Tiled icon will appear in your Graphics submenu. 


Cartography 

Previously our map was 12 blocks by 12, 
which all fitted on the screen at once. With our map 
editor we can make a much bigger map. It could be 
huge, but for the moment let's stick to a grid of 30 
by 30 blocks. You may want to download our ready- 
made map and blocks from magpi.cc/fPBrhM. If 
you load in the map, you should see a blue and red 
maze, a bit like in part one but much bigger. This 
time, though, we have added a new block to indicate 
the finish point in the maze. You should be able to 
scroll around to see the whole map. 


Exporting the data 

Have a play around with the map editor; 
there is some great documentation on the website. 
When you have familiarised yourself with how it 
works, we can think about the task of getting the 
map data into our game. To export the data, go to 
Export in the File menu and when the dialogue 
box opens up, asking ‘export as...’, find a suitable 
place (perhaps a subdirectory called maps) to 
save the map (perhaps as map1), but in the drop- 
down labelled ‘Save as type’, select ‘Json map files 
(*.json)'. This type of file (pronounced ‘Jay-son’, 
short for JavaScript Object Notation) can be viewed 
in a text editor. 
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The player must complete 
the maze in the fastest 
time possible 


An external editor is used 
to create the maze 


The maze is bigger than the : 


game window and scrolls 
around with the player 


V The loadMap() 
function translates 
the data from 
Tiled into our map 
data format 


figure1.py 


001. import json 
002. import os 


m 003. 
4, 004. def loadmap(mp): 
005. with open(mp) as json data: 
po peli 006. d = json.load(json data) 
A When we have rewritten our drawMap() function, we will see 007. mapdata = ("width":d["width"], "height":d["height"]]) 
some jagged edges around the extremities of the drawing area ees. rawdata = d["layers"][@]["data"] 
0909. mapdata["data"] = [] 
JSON and the Argonauts 010. for x in range(0, mapdata["width"]): 
If we open the JSON file, we will see a load of 011. st = x*mapdata["width"] 
curly and square brackets with words and numbers 012. mapdata['dsta"].append( 
spread all over the place, but before you proclaim rawdata[st:st«mapdata[ height" ]]) 
‘It’s all Greek to me^, let's have a look at some 013. 
of the elements so that we can understand the 014. tileset = "maps/" + d["tilesets"][@]["source"].replace( 
structure of the data. If you are familiar with the ".tsx",". json") 
JavaScript language, you'll recognise that the curly 015. with open(tileset) as json data: 
brackets 1 and } are used to contain blocks of code 016. t = json.1oad(json data) 
or data, and square brackets [ and ] are used for 017. 
lists of data. Look at the element called ‘layers’ and 018. mapdata["tiles"] = t[' tiles"] 
you will see data describing our map. 019. for tile in range(0,len(mapdata['tiles"])): 
020. path = mapdata["tiles"][tile]["image"] 
021. mapdata["tiles"][tile]["image"] = 
os.path. basename (path) 
Loading the data 022. mapdata["tiles"][tile]["id"] = 
For this game we don’t actually need all mapdata["tiles"][tile]["id"]+1 
the data that is in the JSON file, but we can load 023. return mapdata 


it all in and just use the bits we need. Let’s make 
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Start blitting blocks here 


A Figure 2 The 
coordinates that 
the map starts from 
are calculated as 
an offset from the 
player, and the 
maze blocks are 
only drawn inside 
the rectangle of the 
game window 


a 5 
s E 
^ 
d 


First block is at this 


—————— — -— offset from player 


"E. 


This is the player 
x,y co-ordinates 


Game Window 


a new module to deal with map handling, like we 
have done in previous tutorials (see The MagPi #76, 
magpi.cc/76). Let's make a new module called 
map3d.py. Python provides a module to import 
JSON files, so we can write import json at the top 
of our mapad.py file to load the module. We'll also 
need to use the os module for handling file paths, 
so import that too. Then we just need to write a 
function to load our map. 


TopTip è 


Looking at 
JSON 


You can look at 
JSON files in any 
text editor, but 

a programming 
one is probably 
best - perhaps 
try Geany. 


> We have added 
a new tile for the 
finish. When the 
player moves onto 
this block, the maze 
is solved 


07 Getting what we need 
Let's make a function called loadmap() 
and use a parameter called mp to pass a file location 
to the function. Have a look at figure1.py to see 
how we write this. You can see that we load in 
our map data into a variable d using the function 
json.load(). Then we can copy the width and 


> 
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Stop blitting blocks here 


height into a dictionary called mapdata. This 
dictionary will hold all the data we need by the 
time we get to the end of the function. Having 
made a temporary copy of the block data (rawdata), 
we can then loop through the values and put them 
in the format we want in mapdata. 


The tileset connection 

One bit of information that we need is 
where to find the details about which images to 
use on each block. This is included as a value called 
‘tilesets’. In this case we will assume that we only 
have one tileset defined, so we can read it in and go 
and find our block images. Except there is a slight 
crinkle in the plan. Our map data refers to the 
tileset file as a .tsx file. What we need to do is go 
back to Tiled and export our tileset from the tileset 
editor as a JSON file. Then, when we import it, we 
just switch the .tsx extension for .json. 


A night on the tiles 

Once we have loaded in our tileset data as 
aJSON file, we can then loop through the tiles 
and get the names of each of our block images. 
You will note that we add one to the id value to 
match the values that Tiled has exported. When 
we have all that data in our mapdata dictionary, 
we can pass that back to our main program by 
writing return mapdata. Going back to our main 


program, we’ll need to add an import for our 
map3d module at the top of the code and then, 
before our draw() function, we can write mapData 
= map3d.loadmap("maps/map1. json") instead of 
our list of zeroes and ones. 


Thinking big 

In part one of this tutorial, our maze was 
12x12 blocks, which just fitted nicely into the game 
area. Now we have a 30x30 maze which, if we draw 
it all, will go off the sides of the game window. We 
need to be able to scroll the map around the screen 
as the player moves through the maze. The way 
we can do this is to keep the bouncing ball in the 
centre of the game area and, as the player moves, 
scroll the map. So, in effect, what we are saying is 
that we are going to draw the map relative to the 
player rather than relative to the game window. 


It's all relative 

To draw our map, we are going to use the 
same basic loops (x and y) as before, but we will 
start drawing our map based on the coordinates 
we calculated for the player screen x and y 
coordinates. With that starting screen position, 
we loop in a range that is either side of the player 
in both directions. See Figure 2 for a visual 
explanation of what we are doing in these loops. In 
simple terms, what we are saying is: ‘Start drawing 
the map from coordinates that will make the player 
appear in the centre of the window. Then only 
draw the blocks that are visible in the window.’ See 
figure3.py for how we have changed the drawMap( ) 
function to do this. 


Extra functions 

You will see in figure3.py that we have a 
couple of new functions that we have not defined 
yet. The first is onMap(), which we pass an x and 
a y coordinate to. These are block locations which 
we test to make sure that the coordinates we are 
asking for are actually on our map, otherwise we 
will get an error. If the x or y are less than 0 or 
greater than the width (or height) of the map, then 
we can ignore it. The other function is findData(). 
This function finds the data associated with a tile 
of a given id. Look at figure4.py (overleaf) to see 
how these functions are written. 
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figure3.py 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 


def drawMap(): 
psx = OFFSETX 
psy = OFFSETY-32 
mx = psx - player["sx" 
my = psy - player[' sy ]«32 


for x in range(player[ x' ]-12, player[ x ]416): 
for y in range(player[ v; ]-12, player[ v; ]416): 
if onMap(x,y): 

b = mapData[ data" ][y] [x] 

td = findData(mapData[ ti1es"], "id", b) 

block = td[ image] 

bheight = td["imageheight"]-34 

bx = (x*32)-(y*32) + mx 

by = (y*16)+(x*16) + my 

if -32 <= bx < 800 and 100 <= by < 620: 
screen.blit(block, (bx, by - bheight)) 

if x == player[ x'] and y == player[' v ]: 
screen.blit('"ball"«str(player[ trame" ]), 

(psx, psy)) 


A The updated drawMap0 function 


map3d.py 


» Language: Python 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 


016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 


# 3dmap module for AmazeBalls 
import json 
import os 


def loadmap(mp): 
with open(mp) as json_data: 
d = json.load(json data) 
mapdata - ("width":d["width"], "height":d["height"]) 
rawdata = d[ iayers"][e][ data] 
mapdata['"data'] = [] 
for x in range(0, mapdata["width"]): 
st = x*mapdata[ width'] 
mapdata[ "data" ].append(rawdata[st:st«mapdata[ height" ]]) 


tileset = "maps/" + d["tilesets"][@]["source"].replace( 
™.tsx",.". json" ) 
with open(tileset) as json_data: 


t = json.load(json_data) 


mapdata["tiles"] = t[' tiles"] 

for tile in range(@,len(mapdata["tiles"])): 
path = mapdata["tiles"][tile]["image"] 
mapdata[ "tiles" ][tile]["image"] = os.path.basename(path) 
mapdata["tiles"][tile]["id"] = mapdata["tiles"][tile]["id"]+1 

return mapdata 
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figure4.py 


figure5.py 


001. def onMap(x,y): 


002. if 0 <= x < mapData[ width"] and ð <= y < mapData[ height]: 
003. return True 

004. return False 

005. 

006. def findData(lst, key, value): 

007. for i, dic in enumerate(lst): 

008. if dic[key] -- value: 

009. return dic 

010. return -1 


A The functions to 
test if a coordinate 
is inside the map 
area - onMap() - and 
findData(). which 
finds tile data for 
map drawing 


TopTip è 


Drawing order 


Remember that 
in the draw( ) 
function, things 
are drawn in the 
order you call 
them, so always 
draw the things 
you want on 

top last. 


Masking the edges 

If we draw our map now, we have lost that 
nice diamond shape map. And if we move the player 
down the map, we get a jagged edge at the top and 
blocks popping in and out of view as our drawMap() 
function decides which ones to draw in the range. We 
can tidy this up by overlaying a frame that obscures 
the edges of the printed area. We do this by having 
an image which covers the whole window but has 
a transparent cut-out area where we want the map 
blocks to be shown. We blit this frame graphic after 
we have called drawMap() in our draw() function. 


001. def doMove(p, x, y): 


002. if onMap(p["x"]+x, p["y"]+y): 
003. mt - 
mapData[ "data" ] [p["y"]+y][p["x"]+x] 
004. if mt -- 1: 
005. p.update({"queuex":x, 
"queueY":y, "moveDone":False)) 
006. if mt -- 3: 
007. mazeSolved - True 


The updated doMove( ) function 


Over the finish line 

If we try to move onto the finish block, we 
won't be able to, as our doMove() function is only 
detecting blocks we can move to as id 1. So we need 
to add another condition. Instead of only testing 
mt for 1, let's make that line if mt == 10rmt == 3: 
(because the id of the finish tile is 3). We can then 
add a variable to set if the player moves onto the 
finish, by adding inside this condition: if mt == 
3: mazeSolved - True. We'll also need to declare 
mazeSolved as global inside doMove() and set its 
initial value to False at the top of our program. 


I can't move! 

Now that we have our map drawing, if you 
are adding in code following on from part one, you 
may notice that we can't move the bouncing ball 
any more. That's because the data we have loaded 
is a slightly different format and has floor blocks 
as id 1 and walls as id 2, so at the moment our 
doMove() function is thinking we are surrounded by 
walls (which were id 1 in the last part). We need to 
change our doMove() function to accommodate the 
new data format. Have a look at figure5.py to see 
what we need to write. 


Finding the exit 

Now that we have tidied up our display and 
got our ball moving again, we'll need to change a few 
of the default values that we start with. In the last 
part, we had the player starting at x = o and y - 3. 
We will need to change those values to 3 and 3 in 
the player data at the top of the code to be suitable 
for this map. We'll also want to change the OFFSETY 
constant to 300 to move the map a little further 
down the screen. We should now be able to guide the 
bouncing ball around the maze towards the bottom 
of the screen, where we should find the finish tile. 
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17 Time is running out 

Let's add a timer to the game. When the 
player reaches the finish (mazeSolved is True), 
we can stop the timer and display a message. 
So, first we make a timer variable at the top of 
our program with timer = 0 and then, right at 
the end of the code, just before pgzrun.go(), we 
can use the Pygame Zero clock function called 
schedule interval(). If we write clock.schedule_ 
interval(timerTick, 1.0), then the function 
timerTick() will be called once every second. 


The clock struck one 

So, all we need to do now is define the 
timerTick() function. We'll need to check if 
mazeSolved is False and add 1 to our timer variable 
if it is. Then we can add a screen. draw.text line 
to our draw() function to display the timer value 
and if mazeSolved is True, we can add some more 
text to say the maze has been solved and how many 
seconds it took. See the full program listing for 
how to write the code for those bits. 

In the next instalment, we are going to add 

some baddies to contend with and, just for good 
measure, we can throw in some dynamite! Ll 
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amazeballs2.py THE FULL CODE: 


» Language: Python © magpi.cc/fPBrhM 
001. import pgzrun player["y"]: 
002. import map3d 055. screen.blit( 
003. "ball"-str(player[ trame" ]), (psx, psy)) 
004. player = {"x":3, "y":3, "frame":0, "sx":0, "sy":96, 056. 
005. "moveX":0, "moveY":0, "queueX":0, "queueY":0, 057. def findData(lst, key, value): 
006. "moveDone":True, "movingNow":False, 058. for i, dic in enumerate(lst): 
"animCounter" :0) 059. if dic[key] -- value: 
007. OFFSETX = 368 060. return dic 
008. OFFSETY = 300 061. return -1 
009. timer = ð 062. 
010. mazeSolved - False 063. def onMap(x,y): 
011. 064. if 0 <= x < mapData[ width"] and @ <= y < 
012. mapData = map3d.loadmap("maps/mapi.json") mapData[ height"]: 
013. 065. return True 
014. def draw(): # Pygame Zero draw function 066. return False 
015. screen.fill((0, ©, 0)) 067. 
016. drawMap() @68. def doMove(p, x, y): 
017. screen.blit('title', (0, 0)) 069. global mazeSolved 
018. screen.draw.text(" TIME: “+str(timer) , topleft-( 070. if onMap(p["x"]+x, p["y"]+y): 
20, 80), owidth-0.5, ocolor-(255,255,0), 071. mt = mapData[ "data" ][p["y"]+y][p["x"]+x] 
color-(255,0,0) , fontsize-60) 072. if mt -- 1 or mt -- 3: 
019. if mazeSolved: 073. p.update(("queueX" :x, "queueY":y, 
020. screen.draw.text( "MAZE SOLVED in " + str(timer) "moveDone" :False}) 
+ " seconds!" , center-(400, 450), owidth-0.5, 074. if mt == 3: 
ocolor-(0,0,0), color-(0,255,0) , fontsize-60) 075. mazeSolved - True 
021. 076. 
022. 077. def updateBall(p): 
023. def update(): # Pygame Zero update function 078. if p["movingNow"]: 
024. global player, timer 079. if p['moveX"] == -1: moveP(p, -1,-0.5) 
025. if player["moveDone"] == True: 080. if p["movex"] == 1: moveP(p,1,0.5) 
026. if keyboard.left: doMove(player, -1, 0) 081. if p['moveY"] == -1: moveP(p,1, -0.5) 
027. if keyboard.right: doMove(player, 1, 0) 082. if p["moveY"] == 1: moveP(p, -1,0.5) 
028. if keyboard.up: doMove(player, 0, -1) 083. p["animCounter"] += 1 
029. if keyboard.down: doMove(player, 0, 1) 084. if p["animCounter"] -- 4: 
030. updateBall(player) 085. p["animCounter"] = 0 
031. 086. p["frame"] += 1 
032. def timerTick(): 087. if p["frame"] > 7: 
033. global timer 088. p["frame"] = e 
034. if not mazeSolved: 089. if p["frame"] == 4: 
035. timer += 1 e9e. if p["moveDone"] == False: 
036. 091. if p["queueX"] != ð or p["queueY"] !-e: 
037. def drawMap(): 092. p.update( ("moveX" :p["queueX" ], 
038. psx - OFFSETX "moveY" :p["queueY"], "queueX":0, "queueY":@, 
039. psy - OFFSETY-32 "movingNow": True}) 
040. mx = psx - player["sx"] 093. else: 
041. my = psy - player['sy"]«32 094 p.update(("moveDone":True, "moveX":0, 
042. "moveY":0, "movingNow" :False)) 
043. for x in range(player[ x ]-12, player[ x ]416): 095. 
044. for y in range(player["y"]-12, player["y"]+16): 096. if p["frame"] == 7 and p["moveDone"] == False 
045. if onMap(x,y): and p["movingNow"] -- True: 
046. b = mapData[ cata" ][y][x] 097. p["x"] += p["movex"] 
047. td = findData(mapData[ ti1es"], "id", b) 098. p["y"] += p["movev"] 
048. block = td[ image"] 099. p["moveDone"] = True 
049. bheight = td[ imsgeheight"]-34 100. 
050. bx = (x*32)-(y*32) + mx 101. def moveP(p,x,y): 
051. by = (y*16)+(x*16) + my 102. p['sx"] += x 
052. if -32 <= bx « 800 and 100 <= by « 620: 103. p['sy"] += y 
053. screen.blit(block, (bx, by - 104. 
bheight)) 105. clock.schedule interval(timerTick, 1.0) 
054. if x == player[ x'] and y == 106. pgzrun.go() 
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I You'll Need 


» Propeller 
development board 
from The MagPi #77 
magpi.cc/77 


» VGA monitor 


P1 Bakery: 


In a spin 


Enhance your Pi by adding a VGA output and a retro 8-bit sound chip 
emulator using the eight-core Propeller chip. This month, generating video 


his month, we will see how this board can 

be made to generate VGA video. Most of 

the examples you'll see for this chip are in 
a standalone context, but we want to use video 
in conjunction with our Raspberry Pi. Therefore, 
we have to take a different approach to normal. 
Instead of interfacing an old PS/2 keyboard 
and mouse, we want to use a serial connection 
between Pi and Propeller, like we looked at last 
month. The best way is to do this is to modify 
what is already in the field; however, this leads to 
some interesting problems that need to be solved. 


The VGA signal 
To drive a VGA monitor, we need to send 
it five signals: two synchronisation pulses and 


mto the breac 
(caa 


the bres 
more into the breach 
to the breach 
the breach 
an unes 


1 
2» more in 


VGA monitor 
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three analogue video signals. Figure 1 shows the 
connection between the Propeller chip and the VGA 
socket, and shows the eight digital signals used. 
The HS, or horizontal sync pulse, tells the monitor 
when to start scanning from left to right, and the 
VS, or vertical sync pulse, starts the top-to-bottom 
scan. The video is generated by two digital lines 
and resistors in a simple D/A (digital to analogue) 
converter, giving four different intensities of each 
colour component: red, green, and blue. 


The video signal 

Inside the VGA monitor is a terminating 
resistor of 75 Q. This, together with the series 
resistors, forms a voltage divider to cut down the 
5V signal from the Propeller chip. Figure 2 shows 
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Propeller board 
generating video 


Video 1 
Video 0 


Sync 


VGA Monitor 


Video Circuits 


Sync Circuits = 1.2V 


Video 1 = 5V 
Video 0 = 5V 
Video Circuits = 1.6V 


Video 1 = 5V 
Video 0 = OV 
Video Circuits = 1.06V 
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Video Circuits 


Video Circuits 


how the voltages reaching the VGA monitor’s 
circuits are determined by which resistors are 
connected to a logic one, or logic zero. These are 
calculated from the resistors in parallel formula, 
and the potential divider formula, but they are 
ultimately derived from Ohm’s law. Note that 
these voltage values are not equally spaced but are 
‘gamma corrected’ so the eye perceives them as 
equal brightness steps. 


Getting started 

The official Propeller Package is called 
ANoo4-GUI-StartVGA-Code-v1.0 by André 
LaMothe. It’s now quite hard to find this code, 
so we have put it on our GitHub page. Out of 
the box, you can compile and load into RAM 
the WMF. HelloWorld, 010.spin code. It's not 
too exciting - it just scrolls a simple message 
continuously - but it'll prove your VGA monitor 
is working. If it doesn't work, then you could try 
altering the VGA resolution to another value. 


VGA socket 


mL. 


P8X32A (DIP) 


(P23) 28 
(P22) 27 
(P21) 26 


(P20) 25 10 
(P19) 24 ; sH 
(P18) 23 7H 
(P17) 22 I$, gli! 
(P16) 21 14 i 
Figure 1 a] 
L 


Altering the video resolution 

At the start of VGA_HiRes_Text_010.spin, 
there are three tables that set up the resolution 
of the display. By default, 800x600 @ 75Hz video 
is enabled, with 100x50 characters displayed. Use 
the curly braces to surround any section of code 
to disable it, and remove the braces surrounding 
the resolution you want to use. These definitions 
are shown in the Mods in, VGA HiRes.spin 


A Figure 2 Converting 
digital signals to 
VGA voltages 


4 Figure 1 Schematic 
for the VGA output of 
the propeller board 
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Mods_in_VGA_HiRes.spin 


» Language: Spin 


001. CON 024. 
002. 025. 
003. (' 1024 x 768 @ 57Hz settings: 128 x 64 characters 026. 
004. 027. 
005. hp = 1024 'horizontal pixels 028. 
006. vp = 768 'vertical pixels 029. 
007. hf = 16 "horizontal front porch pixels 030. 
008. hs = 96 "horizontal sync pixels 
009. hb = 176 'horizontal back porch pixels 031. 
010. vf = 1 "vertical front porch lines 032. 
011. vs = 3 "vertical sync lines 033. 
012. vb = 28 'vertical back porch lines 034. 
013. hn = 1 "horizontal normal sync state (0|1) 035. 
014. vn = 1 "vertical normal sync state (0|1) 036. 
015. pr = 60 'pixel rate in MHz at 80MHz system 037. 
clock (5MHz granularity) 038. 
016. j 039. 
017. 040. 
018. ' 800 x 600 @ 75Hz settings: 100 x 50 characters 041. 
019. 042. 
020. hp = 800 "horizontal pixels 043. 
021. vp - 600 'vertical pixels 044. 
022. hf - 40 'horizontal front porch pixels 
023. hs - 128 'horizontal sync pixels 045. 


hb 
vf 
vs 
vb 
hn 
vn 


pr 


= 88 'horizontal back porch pixels 

=1 'vertical front porch lines 

=4 'vertical sync lines 

= 23 'vertical back porch lines 

=0 ‘horizontal normal sync state (0|1) 
= 0 ‘vertical normal sync state (0|1) 

= 50 'pixel rate in MHz at 80MHz system 


clock (5MHz granularity) 


' 640 x 480 @ 69Hz settings: 80 x 40 characters 


{ 
hp 
vp 
hf 
hs 
hb 
vf 
vs 
vb 
hn 
vn 


pr 


= 640 "horizontal pixels 

= 480 'vertical pixels 

= 24 "horizontal front porch pixels 

= 40 ‘horizontal sync pixels 

= 128 "horizontal back porch pixels 

=9 ‘vertical front porch lines 

= 3 "vertical sync lines 

= 28 ‘vertical back porch lines 

= 1 ‘horizontal normal sync state (0|1) 
21 'vertical normal sync state (0|1) 
= 30 'pixel rate in MHz at 80MHz system 


clock (5MHz granularity) 


} 


. listing. Your monitor might respond to a faster 
Top Ti p à or slower clock rate better, or you might want 


to pack more information onto the display. 


Startup time Remember, after changing the file, go back 
f to the HelloWorld tab to load it into the 

Each timeyou Propeller board. 

open the serial 

port, the Propeller 

processor resets 

and the VGA code 

is loaded in. This Sorting out the files 

takes a little time, Make a folder for your VGA generator 


so we must add 

a small delay to 
allow the VGA 
signals to start up 


and copy the VGA_HiRes_Text_010.spin and 

the WMF_Terminal_Services_010.spin files 

into it from the download. You need to add the 
FullDuplexSerialPlus.spin file to the folder; it 

can be found on our GitHub repository or from 
magpi.cc/MAYjtg. Finally, create a folder called 
Python for our Raspberry Pi code. In the Propeller 
IDE, open up WMF_Terminal_Services_010.spin 
and change the OutTerm function to that shown in 
the Change_to_Terminal_Services.spin listing 
overleaf). Then create a new file and enter the code 
from the HelloPi.spin listing. Download this into 
the RAM and you should see a message on the VDU. 
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Why those changes? 

We are going to communicate with the 
display over a serial port, using strings, and this 
necessitates having a number indicating that the 
string is finished. This is normally the carriage 
return number 13. Also, the Propeller uses null- 
terminated strings, so we can’t send a zero as part 
of a string either. Therefore we have to devise a 
strategy that avoids using those two numbers but 
is still be able to send those values to the display. 
What we have chosen to do is to move the control 
codes to different values and add an offset to the 
positioning values 


07 Colour information 
In a similar vein, colour values are six 

bytes long, and could be mistaken for control 
signals. So we set bit 6 in every colour value, 

and remove it when we receive it - see Figure 3 
(page 62). To make sure we don't mistake normal 
data for colour data, we precede colour data 
with the number 12. Finally, if we send data too 
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HelloPi.spin 


» Language: Spin 


001. 


002. 
003. 
004. 


005. 
006. 
007. 
008. 
009. 
010. 
011. 


012. 
013. 


014. 
015. 
016. 
017. 


018. 
019. 
020. 
021. 
022. 


023. 


024. 
025. 
026. 
027. 
028. 


029. 
030. 


031. 


032. 
033. 


1! File: HelloPi.Spin 
'' Mike Cook 


CON 

' CONSTANTS, DEFINES, MACROS, ETC. 
_clkmode = xtal1 + plli6x 
_xinfreq = 5 000 000 


RxPin - 31 'default boot loader RX 

TxPin - 30 'default boot loader TX 

BaudRate - 115200 'this is a good baud rate 
for 80MHz 

' import some constants from the Propeller 
Window Manager 

VGACOLS = WMF#VGACOLS 

VGAROWS = WMF#VGAROWS 

' set these constants based on the Propeller 
device you are using 

VGA_BASE_PIN = 16 'VGA pins 16-23 
OBJ 

' Propeller Windows GUI object(s) 

SerIO : "FullDuplexSerialPlus" 'object that 
implements serial I/O for the Propeller. 

WMF : "WMF Terminal Services 010" ' include 
the terminal services driver which includes the 
VGA driver itself 


VAR 
' DECLARED VARIABLES, ARRAYS 

byte gVgaRows, gVgaCols ' convenient globals 
to store number of columns and rows 
byte gStrBuff1[64] ' a string buffers 
byte gTextCursX, gTextCursY, gTextCursMode 
text cursor © [x0,y0,modee] 
long gVideoBufferPtr 
' holds the address of the video buffer passed 
back from the VGA driver 


CON 


034. 
035. 
036. 
037. 
038. 
039. 


040. 
041. 
042. 


043. 
044. 
045. 
046. 
047. 
048. 
049. 


050. 
051. 
052. 


053. 
054. 


055. 
056. 
057. 


058. 
059. 


060. 
061. 


062. 


063. 


064. 


065. 


066. 


067. 


' MAIN ENTRY POINT 
PUB Start | S1, N1, CF, CB 


' create the GUI itself 

CreateAppGUI 

SerIO.Start(RxPin, TxPin, 760000, BaudRate) ' 
initialise SerIO object 


' MAIN EVENT LOOP 
WMF.StringTerm(string("Hello World! from the 
Propeller ")) 
repeat 
S1 :- SerIO.getstr(gStrBuff1) 
N1 :- byte[gStrBuff1] [2] 
if N1 == $0ec 
CF := byte[gStrBuff1][1] & $3F 
CB :- byte[gStrBuff1][2] & $3F 
WMF.SetLineColor(WMF.GetRowTerm , CF, 


else 
WMF.StringTerm(S1) 
SerIO.tx (2) ' send an ACK to say that has 
beed processed 


PUB CreateAppGUI | retVal 
' This functions creates the entire user interface 
for the application 
' start the VGA driver and terminal services 
retVal :- WMF.Init(VGA BASE PIN, @gTextCursXx 


' VGA buffer encoded in upper 16-bits of return 
value 

gVideoBufferPtr :- retVal »» 16 

'setup screen colors - see Terminal Services 
themes 

WMF.ClearScreen( WMFAZCTHEME ATARI C64 FG, 
WMFS&CTHEME ATARI C64 BG ) 

'WMF.ClearScreen( WMFHCTHEME AUTUMN FG, 
WMFACTHEME AUTUMN BG ) 

return 
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vga drive.py 


» Language: Python 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 


010. 


011. 
012. 
013. 
014. 
015. 
016. 


017. 


018. 
019. 
020. 
021. 
022. 


023. 
024. 
025. 
026. 


027. 
028. 


029. 
030. 
031. 


032. 
033. 
034. 
035. 
036. 


037. 
038. 
039. 
040. 


041. 
042. 


#!/usr/bin/env python3 
# Class for driving Propeller VDU 
# By Mike Cook Jan 2019 


import serial 
class Vga_drive(): 


def | init (self, chrX,chrY): 
# initialisation 
self.spinProcessor = serial.Serial( 
"/dev/ttyUSBO",115200, timeout = 1) 
self.spinProcessor.flushInput() 
self.spinProcessor.flushOutput() 
self.xWidth - chrX -1 it make first line zero 
self.yWidth = chrY -1 


def sendString(self, send): 
# send a string to the VDU 
buf - 27 
# maximum string size for Pi buffers 
self.spinProcessor.flushInput() 
ln = len(send) 
i-0 
while i < 1n: 
self.spinProcessor.write( 
send[i:i+buf].encode()+ b'\x@D') 
self.waitAck() 
i += buf 


def sendStringLn(self, send): 
# send a string no CR 
self.sendString(send) 
self.sendNl() 


def sendNl(self): # send a new line command 
self.spinProcessor.flushInput() 
self.spinProcessor.write(b'\x@E\x@D') 
# send new line 
self .waitAck() 


def setX(self,pos): # set X cursor 
pos += 14 # can't send zero or 13 so add 14 
if pos < 14 or pos > self.xWidth + 14: 
# outside limits 
print("ERROR ",pos,"IS OUT OF RANGE") 
return 
self.spinProcessor.flushInput() 
S = b'\x@A' + str(chr(pos)).encode() + 
b'\x@D' 
self.spinProcessor.write(s) 
self.waitAck() 


043. 
044. 
045. 
046. 


047. 
048. 
049. 
050. 


051. 
052. 
053. 
054. 


055. 
056. 
057. 
058. 
059. 
060. 


061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
071. 
072. 


073. 


074. 


075. 


076. 
077. 
078. 
079. 
080. 


081. 
082. 
083. 
084. 
085. 


def setY(self,pos): # set Y cursor 
pos += 14 # can't send zero or 13 so add 14 
if pos « 14 or pos > self.yWidth + 14: 
it outside limits 
print("ERROR ",pos,"IS OUT OF RANGE") 
return 
self.spinProcessor.flushInput() 
S = b'Nx0B' + str(chr(pos)).encode() + 
b'WxeD' 
self.spinProcessor.write(s) 
self .waitAck() 


def erase(self,line,start, length): 
# erase "line" from "start" for "length" 
if start + length > self.xWidth: 
length = self.xWidth - start 
sati 
for i in range(@, length): 
sae" ^ 
if line > -1: 
# set line to -1 to use current line 
self.setY(line) 
self.setX(start) 
self.sendString(s) 
self.setX(start) 
if line > -1: 
self.setY(line) 


def waitAck(self): #wait for acknowledgement 
ack = self.spinProcessor.read() 


# set colour for current line 
def setColour(self,rf,gf,bf,rb,gb,bb): # r,g,b 
foreground & r,g,b background 
colF = ((rf & 0x3) << 4) | ((gf & @x3) << 2) 
| (bf & @x3) | 0x40 
colB = ((rb & @x3) << 4) | ((gb & @x3) << 2) 
| (bb & @x3) | ex4e 
S = b'\x@C’ + str(chr(colF)).encode() 
*str(chr(colB)).encode()* b'\x@D' 
self.spinProcessor.write(s) 
self.waitAck() 


def cls(self): # clear screen and set to home 
self.spinProcessor.write(b'\x@1\x@D') 
# clear screen 
self.waitAck() 


def home(self): # go to top left 
self.spinProcessor.write(b'\x@2\x@D') # home 
self.waitAck() 
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Change to Terminal Services.spin 


» Language: Spin 


001. PUB OutTerm( pChar ) 027. $00: case pChar 

002. {{ 028. $00..$01: bytefill( gVideoBufferPtr, 

003. DESCRIPTION: Output a character to terminal, this is ASCII SPACE, gTermNumCols * gTermNumRows) 
the primary interface from the client to the driver 029. gTermCol :- gTermRow :- @ 
in "terminal mode" 030. 

004. direct mode access uses the register model and 031. $02: gTermCol :- gTermRow := @ 
controls the engine from the low level 032. 

005. 033. 

006. PARMS: pChar - character to print with the following 034. $08: if gTermCol 
extra controls: 035. gTermCol-- 

007. 036. 

008. 037. $09: repeat 

009. $00 = Null - can't be represented by a string 038. PrintTerm(" ") 

010. $91 = clear screen 039. while gTermCol & 7 

011. $92 = home 040. 

012. $08 - backspace 041. $0A..$0C: gTermFlag :- pChar 

013. $09 - tab (8 spaces per) 042. return 

014. $0A = set X position (X + 14 follows) 043. 

015. $0B = set Y position (Y + 14 follows) 044. "$@D: NewlineTerm 

016. $@C = set color (color follows) 045. 

017. $@D = return - but can't be passed in a string 046. $0E: NewlineTerm 
from serial 047. 

018. $@E = return 048. other: PrintTerm( pChar ) 

019. others - prints to the screen 049. 

020. 050. $0A: gTermCol :- (pChar-14) // gTermNumCols 

021. 3128 to any other printable character, draw in 051. $0B: gTermRow :- (pChar-14)// gTermNumRows 
inverse video 052. $0C: gTermFlag :- pChar & 7 

022. 053. 

023. RETURNS: Nothing. 054. gTermFlag :- 0 

024. }} 055. 

025. 056. ' end PUB ------------------------------------------ 

026. case gTermFlag MM SS LL LOI LLL LLLLLLLL LLLLLLLLILLA LLL LLÓLÉÓ8Ó Él 


fast, the buffers will be overrun - but if we put 
in a delay, the screen update is slower. To solve 
this problem, we have made the display send an 
acknowledgment back to the Pi when the VDU is 
ready for new data. 


Talking to the display 

We want to communicate with the display 
using Python, and for ease of use we have 
implemented a helper class containing functions 
to make driving the display from any Python 
program easy - this is shown in the vga, drive.py 
listing. Pyserial sends and receives only byte array 
data, and this class does the conversions for you. 
The sendString method can cope with any length 


of string; it does this by splitting up the string 
into chunks of 27 bytes or less and sending each 
separately. Look at each of the methods to see 
what they do; this is your toolkit. 


Using your toolkit 

The vga  demot.py listing (overleaf) shows 
a basic program to send numbers and strings to 
the display. First the screen is cleared and we send 
a message to the top line. Note how we send a 
variable as a string using the str() function, and 
also note the use of the erase() method to blank 
out part of a line with spaces. If we send the line 
number as -1 it will work on the current line, but 
you can use a specific line number as well. The 


Colours 


Once you get a 
theme you like, 
you could hack 
around at the 
bottom of the 
HelloPi code 
and set them 
permanently. Look 
for the variable 
names in the 
WMF,. Terminal, 
Services file. 
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vga demol.py 


» Language: Python 


001. #!/usr/bin/env python3 020. vga.cls() 
002. #demo 1 using Vga drive class driver 021. speed = 0.05 # time between each change 
003. #By Mike Cook January 2019 022. while True: 
004. 023. vga.sendStringLn(" Hello from the Raspberry 
005. import time Pi") # send with CR 
006. 024. for i in range(1,yWide+20): 
007. from vga drive import Vga drive # allow scrolling at the end 
008. 025. vga.sendString(str(i)+s1) 
009. #1024 x 768 @ 57Hz settings: 128 x 64 characters # send number and string 
010. 3800 x 600 (0 75Hz settings: 100 x 50 characters 026. time.sleep(speed*4) 
011. #640 x 480 (0 69Hz settings: 80 x 40 characters 027. vga.sendString(s2) 
012. xWide = 100 ; yWide = 50 # Pick the resolution for 028. time.sleep(speed * 8) 
your VDU settings 029. vga.erase(-1, len(s1)+len(str(i)), 
013. vga - Vga drive(xWide, yWide) len(s1)) # remove last string 
014. time.sleep(1.5) £ let the Propeller chip reset 030. time.sleep(speed) 
015. s1- ") Now is the time to come to the aide of the 031. vga.sendNl() # new line 
party " 032. vga.cls() 
016. s2 - " Again with feeling " 033. 
017. 034. # Main program logic: 
018. def main(): 035. if name == ' main ': 
019. print("Spin VGA driver demo1 - Ctrl C to stop") 035. main() 


program will write more lines than you can fit on colours. The colours to be displayed can be set, 
the screen, so you can see the screen scrolling. but only for one line at a time. The foreground 
and background colours can be set independently, 
but to see them you need them to be different. 
The program in the vga demo2.py listing 


Colour themes displays ten different 'recommended' colour 
In the VGA drivers there is only bit of themes, as well as two fun chaotic or random 
memory per pixel; however, this bit can be themes. Note that the top line can be made to 
displayed as two of any of the 64 available have the inverse of the rest of the window. 
Bit numbers In conclusion 
Well, that about wraps it up from us for this 
7 6 5 4 3 2 1 0 project, but you still have plenty to explore. Look 


at the examples that have multiple bits per pixel, 
giving you more colours and graphic capabilities - 
see our GitHub page for a starting example. We also 
have not broken out all the processor GPIO pins; 


Set Red Green Blue you can add a header strip for ground and the first 
eight pins very easily. All the other unused pins 
A Colour Byte are up for grabs as well. A Propeller processor must 
surely be the most capable and flexible of all things 
P Figure 3 The composition of a colour byte you can add to your Raspberry Pi. El 
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vga_demo2.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 


© magpi.cc/XCwzVh 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 


013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 


025. 


026. 


027. 
028. 
029. 


030. 
031. 


032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 


040. 


#!/usr/bin/env python3 

#demo 2 using Vga drive class driver 
#with added colour theme switching 
#By Mike Cook January 2019 


import time, random 
from vga drive import Vga drive 


#1024 x 768 @ 57Hz settings: 128 x 64 characters 
#800 x 600 () 75Hz settings: 100 x 50 characters 
4640 x 480 () 69Hz settings: 80 x 40 characters 
xWide = 100 ; yWide = 50 
# Pick the resolution for your settings 
vga - Vga drive(xWide, yWide) 
time.sleep(1.5) # let the Propeller chip reset 
random.seed() 
S1 - ") more into the breach dear friends:- 
#colours for themes 
redF =  [3,0,3,0,0,0,3,3,3,0] 
redB [9,3,0,0,2,3,0,3,1,1] 
greenF = [3,0,3,3,0,0,1,3,3,3] 
greenB = [0,3,0,0,2,1,0,1,1,1] 
blueF = [3,0,3,0,0,0,0,3,3,0] 
blueB = [0,3,2,0,0,0,0,0,2,1] 
ThemeNames = ["White on black","Black on 
white", "Atari/C64 theme", 

"Apple ][ ","Wasp/yellow 
jacket","Autumn","Inverse Autumn", 

","Purple 


"Creamsicle", 
orchid","Gremlin","Chaos 1","Chaos 2"] 


def main(): 

print("Spin VGA colour theme demo - Ctrl C 
to stop") 

vga.cis() 

vga.sendStringLn("Hello from the Raspberry 
Pi") 


vga.sendString("starting the theme demo") 
time.sleep(5) # time for monitor to adjust 
while True: 
for j in range(0,12): 
if j >= 10: 
chaos(j & 1) 
else : 
changeTheme(j,1) 
# use 0 for no special top line 
vga. sendStringLn( 


041. 


042. 
043. 


044. 


045. 
046. 
047. 
048. 
049. 


050. 
051. 
052. 
053. 


054. 


055. 
056. 
057. 
058. 


059. 


060. 
061. 
062. 
063. 
064. 
065. 


066. 
067. 


068. 
069. 


070. 
071. 
072. 
073. 
074. 
075. 


"Hello from the Raspberry Pi - Theme 
"4ThemeNames [3]) 
for i in range(1,yWide-1): 
vga. sendString(str(i)+s1) 
# send number and string 
vga.sendStringLn(" Again with 
feeling ") 
vga.sendString("This is the last line") 
time.sleep(2) 
vga.cls() 


def changeTheme(theme, top): # top = 1 if 
inverted 
start = top & 1 
if start !- 0: 
vga.setY(0) 
vga.setColour(redB[theme],greenB[theme], 
blueB[theme], 
redF[theme],greenF[theme], 
blueF[theme]) 


for i in range(start, yWide): 
vga.setY(i) # choose line 
vga.setColour(redF[theme], greenF[theme], 
blueF[theme], 
redB[theme],greenB[theme], 
blueB[theme]) 
vga.home() 


def chaos(t): #just a bit of fun 
for i in range(0,yWide): 
vga.setY(i) # choose line 
c = [random.randint(0,3) for j in 
range(0,6)] 
if t = 1 : 
vga.setColour(c[9],c[1],c[2],c[3],c[4], 
c[5]) 
else: 
vga.setColour(c[@],c[1],c[2],c[@]*3, 
c[1]^3,c[2]^3) st inverse back 
vga.home() 


# Main program logic: 


if name == ' main ': 
main() 
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Can you create an app with just a 
Raspberry Pi and install it on your 
Android phone? Of course you can, 
and here's how... 


he Raspberry Pi is generally considered There are several methods of making mobile 
to be a great platform for learning how to apps. Generally, the way to produce an app is 
program and control electronics projects, to write it using a development system which 
but can you create programs to be used on other compiles your code into a package for a specific 
platforms like PCs or even mobile phones? Well, platform. These are called ‘native’ apps and you 
considering the cost of buying a Raspberry Pi, you would need to compile different versions for 
may think it could be a bit limited for real-world Android phones and iPhones or Windows phones. 
Mark development, but this article will explain how There are other apps which have a native app 
Vanstone you can use your Pi to create a real-world, data- wrapper but then display HTMLs5 pages inside the 
driven, useful mobile app that you can install on a wrapper or maybe even just work inside a web 
Educational phone and use to communicate in real-time with browser. These are called ‘web’ apps. 
software author your Raspberry Pi. The problem with web apps is that they rely on 


from the nineties, 
author of the 
ArcVenture series, 
disappeared into 
the corporate 
software wasteland. 
Rescued by the 
Raspberry Pi! 


having a connection to the internet to view the 
HTML pages, and any data handling will generally 
require calls to server-side scripts and databases, 
as with normal webpages. Now, there is a solution 
to this problem and it is called ‘PWA’. That stands 
for ‘progressive web app’ and has elements of the 
way a native app works, but can be programmed 
using webpage coding. 
A PWA can keep a copy of the app screens and 
even a local copy of database data so that when 
there is no internet connection it still works. It 
can also be installed onto a mobile phone, with its 


sons 


In the Firebase 
Console, under 
Authentication, 
you can set up 
users for your app 


You can allocate sign-in details for your Data is read from the 
Firebase Firestore, which 


is a NoSQL database 


users in the Firebase Console 


RPi Treasure Hunt 


Emal HESSEN 


Posso! REENNENNNEM 


Sign In 


Something Animal 


Between the tallest tree and the bend in the river you will find me 


Found tt 
Treasure Code =e 


When the app launches, it checks that 
it has started the Firebase framework 


own icon on the home screen and, when launched, 
looks and works like a native app. 

To write a PWA on the Raspberry Pi, anda 
system to capture data from the app and then 
make external electronics do things in response, 
we are going to get the help of a framework by 
Google called Firebase. . 


The players input a code 
when they find an item, which 
sends a message to the 
Firebase Realtime Database 


We will make a 
treasure hunt app 
for mobile phones 


This is a very simple example and the scope of what can be done with 
; y . rogressive web apps is much greater. For a lot of mobile a rojects, 
. So here's the plan: using Raspbian, we will i Hub d: ae quite dps and perhaps it needs pus asked 
install the necessary modules on the Raspberry Pi if it is necessary to submit apps to the App Store or Play Store (and the 
and set up a new Firebase project. We will make cost incurred in that) when a simple link can be sent to a user who can 
a treasure hunt app for mobile phones which will install a functional app that can look and feel like a native app. There is 
talk to a Python program on the Raspberry Pi. extensive documentation on the Firebase site covering all the elements of 
the framework. Google is committed to supporting PWA technology, and 
Microsoft has said that it will support it too. Although Apple is less vocal about 
its support, a PWA shortcut does install an app on an iPhone and the PWA 
acts to the user like a native app. To see a list of what is available through a 
this can be developed and deployed from the PWA, view the chart at whatwebcando.today. Excepting a few hardware- 
Raspberry Pi! specific functions of a mobile device, the list provides a great range of 
functions which will no doubt expand as more PWAs are made and used. 


That program will use the GPIO pins to light up 
coloured lights for each team as they find hidden 
treasure or complete the treasure hunt. All of 


A step-by-step guide to building your mobile app 


You'll Need 


Raspbian 
(latest version) 


Nodes 
magpi.cc/ogOWTs 


firebase-tools 
firebase.google.com 


Pyrebase Python 
module 
magpi.cc/OPQUtg 


Android phone 


LEDs, resistors, 
jumper wires, and 
breadboard 


the app 


Getting the right version of Node.js 
The first thing to do is get Node.js installed. 
Unfortunately, currently the version that is 
available via the apt-get command is not up-to- 
date enough, so we need to do a manual install. 
Head over to magpi.cc/ogOWTs and download 
the ARM package. To find out which version you 
need, type uname -minto a Terminal window. Most 
Pi models will need the v7 package. You will need 
to unpack the file to a suitable directory (home 
directory is fine) and then, in the Terminal window, 
go to the unpacked directory with, for example, 
cd node-v10.15.1-linux-armv71. Now type sudo 
cp -R * /usr/local/ to copy the files over. 


Get Firebase tools 
Firebase needs to use Node.js for its toolset 
and once you have the Node files in place, you can 


manifestjson 


Language: JSON 


eei. ( 

002. "short name": "RPiTreasure", 
003. "name": "RPi Treasure Hunt", 
004. "icons": [ 

005. { 

006. src": "/images/rpit192.png", 
007. "type": "image/png", 
008. "sizes": "192x192" 

009. » 

010. { 

011. src": "/images/rpit512.png", 
012. "type": "image/png", 
013. "sizes": "512x512" 

014. ) 

015. if 

016. "start url": "/", 

017. "background color": "#fff", 
018. "display": "standalone", 
019. "scope": "/", 

020. "theme color": "#fff" 

021. } 


check that they are ready to use by typing node -v, 
which should reply with the version you have just 
installed (10.15.1 in our case). You can also check 
the Node Package Manager by typing npm -v. We 
will need npm to install the Firebase tools. We do 
that by typing sudo npm install -g firebase- 
tools into the Terminal window. The install will 
take a little time; when it’s finished, run the same 
command again, to update one last package. 


Get a Firebase account 

Google very kindly provides basic access to 
its Firebase service for free. All you need to do is 
register for an account at firebase.google.com and 
you'll be able to do all the things in this tutorial. You 
can do this by signing in with your existing Google 
account, if you have one. Google also provides a 
sliding scale payment system if you need to expand 
your requirements. When you have your account, 
you'll be able to access the Firebase console at 
console.firebase.google.com. On the console front 
page, you'll see an option to add a new project. 


The new project 

Select the ‘Add Project’ button and you can 
set up your Firebase project. You'll need to type ina 
project name and accept the terms and conditions, 
then select ‘Create project’. When the project 
has been created, you'll be taken to the Firebase 
console where you'll see a range of tools down the 
eft-hand side. We will be using the ‘Develop’ tools 
which should be shown here. First, let's look at 
Authentication. You'll need to set a sign-in method, 
for which *Email/Password' can be enabled. Then, 
in the ‘Users’ tab, you can Add a user. Also at this 
stage, go into the Database section and create a 
Firestore database. 


Storage 

Firebase offers three categories of data 
storage. The first is database storage from which 
we can use either Firestore or the Realtime 
Database (more on this later). The second is 
labelled as ‘Storage’ in the menu, which provides 
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DOWNLOAD 
THE FULL CODE: 


© magpi.cc/OdnyDP 


treasure.py 


> Language: Python 


001. import pyrebase 031. for v in d.values(): 

002. import time 032. updateTeam(v["email"], v["item"]) 

003. from gpiozero import LED 033. 

004. 034. def ledFlash(t): 

005. config - ( 035. for f in range(5): 

006. "apiKey": "Your apiKey goes here", 036. led[t].on() 

007. "authDomain": "Your hosting domain goes here", 037. time.sleep(.2) 

008. "databaseURL": "Your hosting URL goes here", 038. led[t].off() 

009. "projectId": "Your project id", 039. time.sleep(.2) 

010. "storageBucket": "Your storage domain", 040. 

011. "messagingSenderId": "Your sender id" 041. def ledOn(t): 

012. ) 042. led[t].on() 

013. 043. 

014. firebase - pyrebase.initialize app(config) 044. def updateTeam(t,i): 

015. numberOfTreasure - 3 045. for td in teams: 

016. led = {} 046. if teams[td]["email"] == t: 

017. teams = {} 047. if i not in teams[td]["treasure"]: 

018. teams[@] = {"email":"test1l@rpitest.com", 048. teams[td][ treasure" ].append(i) 
"led":17,"treasure":[]) 049. if len(teams[td]["treasure"]) >= 

019. teams[1] = {"email":"test2@rpitest.com", numberOfTreasure: 
"led":18, "treasure":[]) 050. print(t+" complete!") 

020. teams[2] = {"email":"test3@rpitest.com", 051. ledOn(td) 
"led":22,"treasure":[]} 052. else: 

021. teams[3] = {"email":"test4@rpitest.com", 053. ledFlash(td) 
"1ed":23, "treasure":[]) 054. 

022. 055. def streamHandler(message): 

023. for f in range(len(teams)): 056 if message[ event'] == "put" or 

024. led[f] = LED(teams[#]["led"]) message['event"] == "patch": 

025. led[f].off() 057. processMessage(message['data'"]) 

026. 058. 

027. db - firebase.database() 059. myStream - db.child( msg ).stream(streamHandler) 

028. 060. 

029. def processMessage(d): 061. while 1: 

030. if(d !- None): 062. time.sleep(.1) 


an area to store files generated by an app. The 
third, which we will look at now, is ‘Hosting’. If we 
go into the Hosting section, we'll see instructions 
about installing firebase-tools, which we did 
previously. Then there are instructions about how 
to set up the project on your Raspberry Pi - so let's 
follow along with them. 


Local projects 

First, in our Terminal window, make a 
directory for our app with mkdir appname. Then 
cd appname to go into that directory. From the 
Firebase instructions, type firebase login. A 
browser window will appear and you'll be asked to 
log in to your Google/Firebase account. With that 


Wy} 


done, go back to the Terminal window and type 
firebase init. You'll be asked which features 
you'd like to use, which could be all of them for 
the moment. It will ask you to select your project, 
then it'll ask you a string of questions about 

your project. Just select the default option (press 
ENTER) for all of the questions. 


07 Setup done 
Now Firebase has set up a default project for 
us, which has everything we need to build our app. 
Go back to the Firebase Console and select ‘Finish’ 
(we'll deploy a bit later). Inside our app folder we 
will find another folder called public. Inside this we 
have our index.html file, which is where our app 
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SW JS 


Language: JavaScript 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 


014. 
015. 


016. 

var cacheName = 3 017. 

var filesToCache = [ 018. 

i 019. 

t 029. 

S 021. 

IE 022. 

023. 

self.addEventListener( , function(e) { 024. 

console.log( ); 025. 
e.waitUntil( 

caches.open(cacheName).then(function(cache) { 026. 

console.log( 027. 

J; 028. 

return cache.addAll(filesToCache); 029. 


}) 


will be built. Let's have a look at that file: open your 
favourite programming editor (you could try Geany 
if you are undecided) and load the index.html file. 
Now go to the Firebase console, select the cog next 
to ‘Project Overview’ and select ‘Project Settings’. 


Add some Firebase 

In the Project Settings page, near the 
bottom you'll see a panel saying that there are no 
apps in your project. Select the round web icon 
(</>) and you'll get a pop-up with some JavaScript 
code. Copy that code and go back to editing your 
index.html file. Now replace the code that starts 


IS THIS ANY GOOD FOR 
REAL APPS? 


Of course, you will get nay-sayers proclaiming that if it is not a native app 
then it's not a real app, and the restrictions of the App Store and Play Store 
currently mean that it is difficult to adapt a PWA for distribution that way. 
The fact of the matter is that in industry, the cost of any project is key to it 
happening and while native app development is a very costly activity, PWAs 
can be coded in a fraction of the time and have no restrictions of the App 
Store or Play Store. That's not to say that PWAs cannot be published through 
those portals, it's just that they have to be wrapped in a framework like 
Cordova to make them into native apps. 


For the maker/coder community, the ability to publish apps without 


these restrictions is no doubt a benefit and possibly a technology that will 
supersede the platform-dependent stores. If nothing else, PWA technology 
gives us a great opportunity to create useful apps with just a Raspberry Pi. 


)3 
35 


self.addEventListener( E 


event => { 


event .waitUntil(self.clients.claim()); 


35 


self.addEventListener( 


, event => { 


event .respondwith( 


caches.match(event.request, 


{ignoreSearch:true}).then(response => { 


)i 
35 


return response || fetch(event.request); 


}) 


<!-- update the version number and ends 
/init.js></script> with the code you have 

just copied from the Firebase console. This bit of 
code will connect our web app with the Firebase 
services. We can now deploy our test app by going 
back to our Terminal window and typing firebase 
deploy. After uploading the necessary files, the 
app will be ready for testing in a browser. 


Testing testing 

We can test on the Raspberry Pi Chromium 
browser or on a mobile device, but make sure that 
you are using either Chrome or Chromium. Other 
browsers do support PWAs, but let’s keep it simple 
for now. After the project has been deployed, 
we'll be given a web address of the hosting URL 
in our Terminal window. Go to this address ina 
browser and you should see confirmation that 
the app is working and has connected. You can 
also test locally if you set up the Chrome Web 
Server extension. If you don’t see a message 
saying ‘Firebase SDK loaded with auth, database, 
messaging, storage’, then go back over the 
previous steps 


Let’s make an app 

The first thing to code will be the app that 
goes on the phone. Have a look at the listing of 
index.html. What this script does is to present a 
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index.html 


» Language: HTML 


001. <!DOCTYPE html» white; 
002. «html» 039. position: fixed; bottom: 0;padding-top: 
003. «head» 5px;padding-bottom: 5px; 
004. «meta charset="utf-8"> 040. width: 100%; height:18px; 
005. «meta namez"viewport" content="width=device- 041. } 
width, initial-scale=1"> 042. input{ -webkit-border-radius: 3px; 
006. «link rel="manifest" href="/manifest.json"> -moz-border-radius: 3px;border-radius: 
007. «title»Welcome to The RPi Treasure Hunt«/title» 3px;margin:3px;padding:2px) 
008. «script srce"https://www.gstatic.com/ 043. button { 
firebasejs/5.8.1/firebase.js"»«/script» 044. border:1px solid #000; -webkit-border-radius: 
009. «script» 3px; -moz-border-radius: 3px;border-radius: 3px;font- 
010. // Initialize Firebase size:12px;font-family:arial, helvetica, sans-serif; 
011. var config = { padding: 10px 10px 10px 10px; text-decoration:none; 
012. apiKey: "Your apiKey goes here", display:inline-block;font-weight:bold; color: #fff; 
013. authDomain: "Your hosting domain goes here", 045. background-image: -webkit-gradient(linear, 
014. databaseURL: "Your database URL goes here", left top, left bottom, from(rgb(77, 77, 77)), 
015. projectId: "Your project id", to(rgb(29, 29, 27)));; 
016. storageBucket: "Your storage domain", 046. } 
017. messagingSenderId: "Your sender id" 047. «/style» 
018. E 048. «/head» 
019. firebase.initializeApp(config); 049. «body» 
020. «/script» 050. «div id="title"> 
021. «script» 051. «hi»RPi Treasure Hunt«/h1» 
022. if('serviceWorker? in navigator) ( 052. «/div» 
023. navigator. serviceWorker.register(‘/sw. js’) 053. «div id="content"> 
024. .then(function() ( 054. Loading RPi Treasure Hunt App. 
025. console.log(*Service Worker Registered’); 055. </div> 
026. )5 056. «p id="load">Connecting ...«/p» 
027. } 057. «script» 
028. «/script» 058. clues - null; 
029. «style media="screen"> 059. email = '"'; 
030. body { background: #fff; color: #000; font- 060. document . addEventListener( *DOMContentLoaded' , 
family: Helvetica, Arial, sans-serif; margin: function() ( 
0; padding: 0; text-align: center; background: 061. try { 
url(images/logo.png) no-repeat 50% 300px fixed; 062. let app - firebase.app(); 
background-size: 50% } 063. let features = [‘auth’, ‘database’, 
031. #title{ background: #000;color:#fff} ‘messaging’, ‘storage’ ].filter(feature => typeof 
032. #signin{ margin:10px; padding:10px;) app[feature] === ‘function’ ); 
033. #signout{ position: fixed; bottom: @px;text- 064. document.getElementById( ‘load’ ).innerHTML = 
align: center} "Connected to Treasure Hunt. > ; 
034. .clueholder( background:#ca@d4c; color:#fff; 065. firebase.firestore().enablePersistence(); 
border:10px solid #fff; margin:@px; padding:10px;- 066. } catch (e) { 
webkit-border-radius: 15px; -moz-border-radius: 067. console.error(e); 
15px;border-radius: 15px;) 068. document.getElementById( ‘load’ ).innerHTML = 
035. . theClue{display:none} ‘Error connecting to the Treasure Hunt.’ ; 
036. #loginform{background: #ca@d4c; color :#ffF;p 069. } 
adding:10px;text-align: right;width:300px;margin: 070. p; 
auto; -webkit-border-radius: 3px; -moz-border-radius: 071. firebase.auth(). 
3px;border-radius: 3px;) onAuthStateChanged(function(user) ( 
037. itload { 072. window.user = user; // user is undefined if 
038. display: block; text-align: center; no user signed in 
background: 31000; text-decoration: none; color: 073. console.info("user changed - is now "+user); 
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FEATURE 


YY 


075. 
076. 
077. 


078. 
079. 
080. 
081. 
082. 


083. 


084. 


085. 
086. 
087. 
088. 
089. 
090. 
091. 
092. 


093. 
094. 
095. 
096. 
097. 
098. 
099. 
100. 
101. 
102. 
103. 
104. 
105. 


106. 
107. 
108. 
109. 
110. 
111. 
112. 
113. 
114. 


115. 
116. 
117. 


if (user == null)( 


Q; 
Jelse( 
(‘load’).style = 
"display:none" 
Q; 
} 
H; 
signinUser(){ 
email = ("email"). 
password = ("pass"). 
firebase. (Q. 
(email, password) 
( (err) { 
(err); 
H; 
} 
getClueData(){ 
db = firebase. O; 
db. ("Clues").get(). 
( (querySnapshot) ( 
(querySnapshot) ; 
H; 
} 
signoutUser(){ 
firebase. (). () 
( (err) { 
(err); 
H; 
} 
openThisClue(o){ 
cluelist = 7 
(‘theClue? ) 


for(c=0;c<cluelist. length; c++){ 
cluelist[c].style = "display:none"; 


} 

theclue = z (0); 

theclue.style = "display:block"; 
} 

foundItem(i){ 

code = ("clueCode_"+i). 
3 

clues. ( (doc){ 

if(doc.id == i && code == doc. (m 


("we have a winner"); 
newMsgKey = firebase. 


0. 


X 


119. 
120. 
121. 
122. 
123. 
124. 
125. 


126. 


127. 
128. 
129. 
130. 
131. 
132. 


133. 
134. 
135. 
136. 
137. 
138. 
139. 


140. 
141. 
142. 
143. 
144. 
145. 
146. 


147. 
148. 


149. 
150. 
151. 
152. 


(msg?) .push() .key; 
postData - ( 
email: email, 
item: i 
J; 
updates = {}; 
updates[ ‘/msg/’ + newMsgKey] = postData; 


firebase. ().ref(). 
(updates) ; 
("clue "4i).style 

= "display:none" 
} 
H; 

} 
setLoginPage(){ 
(‘content’). 


innerHTML = "<div id=’ loginform’ >Email: 

«input id=’email’ type=’ text’ ><br>Password: 
<input id=’pass’ type=’ password? ><br><button 
onclick=’ signinUser();’>Sign In</button></div>"; 


} 
getClueDisplay(cluelist){ 
out = ""; 
clues = cluelist; 
clues. ( (doc){ 
out += ><div class-"clueholder" 
id-"clue ^4doc.id&^ "»«button 


onclick="openThisClue( ‘clueDetail_~+doc. 
H^ 7)"» 4doc. Q. + «/button»«div 
id-"clueDetail "4doc.id& " class-"theClue"»«p»' +doc. 
().cluer «/p»«p»Treasure Code: «input 
id-"clueCode "-4doc.id&^ " type="text"><button 
onclick="foundItem( “`+doc.id+ ° )">Found It!</ 
button></p></div></div>` ; 


H; 
return out; 
} 
setCluesPage(clues){ 
out = (clues); 


out += "<div id=’signout’ ><button 
onclick=’ signoutUser()’>Sign Out</button></div>"; 
(‘content’) .innerHTML 
= out; 
} 


</script> 


</body> 
</html> 


magpi.cc 


Develop an Android app 


sign-in page to allow users (defined in our Firebase 
Authentication) to sign in and then it gets a list 

of clues from the Firebase Firestore database 

and displays them. When a user finds an item 

of treasure, there will be a code number (we will 
set this in our Firestore) which, if they enter it 
correctly, will remove that clue from the list and 
send a message to the Firebase Realtime Database. 
There are two types of database that Firestore 
supports: the Firestore that our treasure hunt data 
is in, and the Realtime Database. 


Realtime Database 

The Realtime Database will trigger an 
event if another program is listening when data 
changes. That's how we'll transfer data back to 
our Raspberry Pi. We need to make an adjustment 
to the security rules to make this easy. Note that 
this is not a good idea for production purposes, 
but we can change the security so that we can read 
and write to the database without authentication. 
We do this by going to the Realtime Database in 
the Firebase console, selecting the ‘Rules’ tab, and 
changing the ‘.read’ value to true - and the same 
with the '. write! value. Normally we would want to 
have a bit more security around a database, but for 
this example we'll keep it simple. 


Make the app act like an app 

There are a couple of other things we need 
to add to make our app installable on a mobile 
phone. The first is the sw.js file. This is a service 
worker file and enables us to cache files so that 
they don't need an internet connection to load. 
You'll see the script to register this file in index. 
html. The other is a manifest file that allows the 
app to be installed and will produce a message 
asking the user if they want to install it. The 
manifest file is linked near the top of index.html. 


The Python connection 

We need to gather the data that is being 
created by our app - this could be done with a 
simple webpage on our Raspberry Pi, but that 
would be boring. Why not have a score indicator 
with flashing lights and things like that? To make 
this, we?ll need to write a Python program. Have a 
look at treasure.py and see how we do this... but 


wait: we need to have access to a module called 
pyrebase, which is a wrapper for the Firebase 
functions and makes it really easy for us. To 
install it, just type pip3 install pyrebase into a 
Terminal window. 


Wiring up 

To be honest, you could have any sort of 
grand scheme for a scoreboard, but we can wire 
up an LED for each team or player in our treasure 
hunt. See the wiring diagram (Figure 1) we are 
using, which will flash the team's LED when they 
discover treasure and keep the LED lit when they 
have finished. If you have lots of players, you may 
want to use LED strips or even a much larger build. 


What does this mean? 

What we have done is to create a real-world 
app for mobile devices with just a £35 Raspberry 
Pi and a free Google account. This is quite a new 
development and, even as this article was being 
written, the Firestore service went from beta to 
live. This means that things may change quite 
quickly, so you may need to refer back to the 
Firebase website for updates. 


Figure 1 How to 
connect four LEDs. 
You can flash the 
LEDs when data is 
received using GPIO 
connections 
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ArduinoPixed 


> Reference Designer, Inc » magpi.cc/FQsHFX » From £18/ $23 


PORTS: 
3 x USB 2.0 


FEATURES: 
1x LED 


1 x Thermistor 
(heat sensor) 


1 x Push-button 


ASSEMBLY: 
No soldering 
required 


P Itsits perfectly 
underneath the Pi Zero, 
with very little in the 
way of overhang 


Is this Arduino-on-Pi made easy? Rob Zwetsloot digs 
out a Zero to give it, and its USB hub functionality, a try 


Raspberry Pi is a common goal in the wider 

maker community. Right now, Arduino 
microcontrollers can do very specific stuff better 
than the Pi, and vice versa, so combining the two 
can be an amazing way to truly power up a project. 

This is where the ArduinoPixed comes in. It 

a relatively inexpensive add-on for the Pi Zero 
(yes, its twice as much as a Pi Zero, but that i 
already extremely cheap) that sits comfortably 
underneath the latter, connecting via pogo pins 
and a bit of friction from the supplied screws. This 
instantly gives you access to three USB 2.0 type-A 
Sockets, but the real magic begins once you install 
Arduino software on the Pi. 


G etting Arduino hardware working with a 


n 
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From here, you can start doing simple things: 
program the LED to blink, have it interact 
with the button, etc. The on-board chip is an 
ATmega328, and with the series of A/D extension 
pins on the board, you can start controlling a little 
more stuff. 


Perfectly sized 
The standard Arduino IDE controls the Arduino 
side of the ArduinoPixed, meaning you don't 
need to learn anything particularly new to get it 
working - unless this is your first time using an 
Arduino system, that is. 

There are some great example programs to 
follow along with, to get you used to how the 


m One of the best solutions 
we've seen for marrying 
Raspberry Pi and Arduino - 
with minimal construction 
and setup time Ø 


Pixed works on the Pi, allowing for a jumping-off 
point to control other bits and pieces with the 
Arduino side of the pair. 

The whole board fits very neatly over the Pi 
Zero, keeping the GPIO pins clear so you can 
interact with them, with only part of a USB port 
overhanging the usual form factor. It does add 
alot of depth to the Pi Zero's footprint - while 
unavoidable, the jump from around 6 mm to 
18mm is significant. 


Joined together 

With a few Pi/Arduino combos we've seen, 

the Arduino part can often be used separately 
from the Pi. Due to the way the ArduinoPixed is 
powered, you could technically do this, but it's 
not as easy as more dedicated Arduino boards 
with a dedicated power input. Still, none of those 
interacts with a Pi in the same way. 


Speaking of Pi interaction, it's worth noting 
that the Pixed does not fit onto a standard-sized 
Raspberry Pi model. As well as the mounting 
points only properly working on a Pi Zero, the 
pogo connectors specifically require the layout on 
the underside of the Zero. It's not something a 
little solder can't fix if you're really determined, 
but out of the box is a different matter. 

Either way, it's one of the best solutions we've 
seen for marrying Raspberry Pi and Arduino - 
and it works very well to boot, with minimal 
construction and setup time. We look forward to 
the next big project that requires it... HI 
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<4 The three USB ports it 


adds to the Pi Zero are 
very welcome 


It does add a lot of depth 
to a Pi Zero's footprint, so 
your regular case wont 
really work 


A quick build, even 
quicker software 
setup, and you're 
away with a 
fantastic marriage 
of Arduino and 
Raspberry Pi. 
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Argon One 


> Argon Forty » magpi.cc/oeEidS » £23/S25 


A robust metal case with a hidden GPIO 


port. By Gareth Halfacree 


surprises. Whereas most Raspberry Pi cases 

are made out of plastic, the bulk of the Argon 
One is solid aluminium - and it's immediately 
noticeable, even before it's taken out of the box. 

Inside the hefty shell is a board which connects 

to the Raspberry Pi's GPIO header, giving ita 
smart power button - found at the rear of the 
case - which comes with software to allow the Pi 
to be safely shut down with a single press. There's 
also a fan, and a daughterboard which snaps into 
a Raspberry Pi 3B or 3B+ to shift its HDMI and 
analogue audio-visual (AV) ports to the rear. 


l ts the weight of the Argon One that first 


W Sleek and heavy, the Argon 
One adds cooling and a smart 
power button to a Pi 3B or 3B* 
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Assembly is quick and easy: click the 
daughterboard home, add a bundled thermal pad 
to the Pi’s processor, slide everything onto the 


GPIO header, then screw it home before adding the 


plastic base. 


Lower temperatures 
Using the large aluminium case as a heatsink 
makes a real difference to temperatures: an 
uncased Pi 3B+ quickly reaches 65°C running a 
CPU-heavy benchmark, but peaks at 40.8°C in the 
Argon One. Sadly, the fan makes little difference, 
but it can be turned off in the bundled software. 
There’s only one real flaw in the Argon One: it 
draws too much power, causing the Pi to flash the 
‘undervoltage’ lightning symbol and throttle its 
performance. It’s a flaw that can only be fixed by 
purchasing Argon Forty’s recommended power 
supply at an extra £11 / $12.50. M 


A. Aclever daughterboard 
moves the Pi's HDMI 


and AV ports to the rear, 
tidying the cabling 


DIMENSIONS: 
106x95x34 mm 


WEIGHT: 
180g 
(excluding Pi) 


MATERIALS: 
Aluminium 
upper, plastic 
lower 


BOARDS: 
Argon Forty 
Power Board, 
Argon Forty 
HDMI/AV 
Daughterboard 


Verdict 


The Argon One 
is attractive, and 
hiding the GPIO 
header under a 
magnetic cover 
is clever. You 
should factor in 
the cost of the 
recommended 
power supply. 
The poor fan 
performance is 
the only real issue. 
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OOroSsJIEFI IPED 


GE 


THE OFFICIAL The only guide you 
need to get started 
with Raspberry Pi 


H 
| OW to use your new Computer 


e Learn how to set up the Raspberry Pi, 
install an operating system, and start using it 


* Follow step-by-step guides to code your 
own animations and games, using both the 
Scratch and Python languages 


e Create amazing projects by connecting 
electronic components to the Pi's GPIO pins 


£10 with 
worldwide delivery 
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Keybow 


> Pimoroni » magpi.cc/MytktH » £50/$54 


A mini mechanical keyboard 
with light-up keys. By Phil King 


ith customisable key mapping, this DIY 
W keypad could be used for a wide range 

of purposes, such as a games controller, 
hotkey pad for applications, or to insert text/code 
snippets with a single key press. 


Solderless assembly takes around 20 minutes. 
After attaching the supplied Pi Zero WH to an 


acrylic baseplate and shim, you push-fit the twelve 


switches into a key plate, slot that into the PCB 
board, then mount it on the Pi’s GPIO header. 
You do need to supply your own microSD card 
to hold the tiny (26.6MB) Keybow OS. Upon 
connecting the Keybow to a computer via the USB 


WY You have the choice of 
clicky or linear (quiet) 
keys. The switches fit 
easily into a key plate 
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A The keys can be lit up in 
static or animated patterns 
for dazzling displays 


OTG cable, the OS is loaded into a RAM disk and it 
boots up in a mere 10-15 seconds. 

One problem we encountered was getting the 
USB cable to insert fully into the Pi's USB OTG port, 
as it was obstructed by a thin bar on the acrylic 
shim - breaking that off solved the issue. 


Custom keys 

Once connected, the keys light up in an animated 
rainbow pattern (determined by a PNG file). The 
default key mapping is a numerical pad. 


M The OS is loaded into a 
RAM disk and it boots up 
in a mere 10-15 seconds Ø 


To change lighting and key mapping, you need 
to slot the microSD card back into your computer - 
there's no way to switch instantly between them. 
Editing a Lua file lets you select a sample key 
layout or your own custom one. An online tutorial 
explains how: magpi.cc/WdAWZc. 

The real power of the Keybow lies in creating 
advanced macros to trigger a whole series of key 
combinations with just a single key press - ideal 
for repeated key-based tasks in applications. El 


KEY 


SWITCHES: 
12 x Kailh 
Speed 


LIGHTING: 
12 x APA102 
RGB LEDs 


BREAKOUT: 
FC 4-pin 


DIMENSIONS: 
85x56.5x38 mm 


Verdict 


A little expensive 
and we had 
problems with the 
USB connection, 
but it looks cool 
when lit up, the 
key action is good, 
and it could prove 
handy for instant 
key sequences. 


8 10 


ie NEW 
MODERN MAKER 


MAKE BUILD HACK CREATE 


HackSpace 


TECHNOLOGY IN YOUR HANDS 
ACCESSIBLE Extreme 
CONTROLLERS ics 


DRONG TOLL ji a m 14 d 
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ISSUE #16 


hsmag.cc 


ø Available on the GETIT ON 
@ AppStore P» Google Play 


WE Mägi | REVIEW 


> SB Components >» magpi.cc/MDAIHB » From £5/S7 


PiShell 


Verdict 


A solid case with 
a clever design 
that can house a 
Camera Module 
and be wall- 
mounted. We 
think the PiShell is 
a great option. 


8 10 
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MATERIALS: 
ABS plastic 
with dual- 
shot injection 
moulding 


MOUNTS: 


A Each layer is made 


of a different colour 
to offer a range of 
designs 


The Camera Module 
is mounted in the 
middle layer 


Camera and 
wall mounting 


COOLING: 
Three vents 
double asa 


compelling case option that might just fit 
your needs. 

Made of high-quality materials, the PiShell 
offers a couple of features that lift it above the 
raft of Raspberry Pi cases. 

The case is made of three parts: a ‘base- 
bumper’ that holds the Raspberry Pi board; the 
*body-cover' that covers the board (with access 


T he PiShell from SB Components is a 


m A very good-looking case, 
available in a range of 
colour combinations El 


holes for the GPIO pins, camera connector, and 
DSI display connector; and the ‘camera-cover’, 
which seals the whole device. 

Camera Module integration is one of the key 
features that raise PiShell above the rest. The 
Camera Module board screws on to the middle 
board (the ‘body-bumper’) via two supplied 


heatsink 


This three-piece case locks a Raspberry Pi and Camera 
Module together. Lucy Hattersley takes a look 


screws. Once assembled, the camera points out 
through a hole in the case. 

With the case flat on a surface, the camera 
points straight up, which we found handy for 
testing out with the Teachable Machine project 
(see page 40). 


Wall mountable 

On the reverse of the device are two holes 

for wall-mounting the device. We can see it 
neatly turning into a smart security camera or 
camera doorbell. 

The case is made of ABS (acrylonitrile 
butadiene styrene) plastic. So it's got a nice feel, 
with good protection for your Raspberry Pi. There 
are vents on both the front and back. 

The PiShell is a very good-looking case, 
available in a range of colour combinations. You 
can also buy a pack of five for £20 - good value 
for schools or clubs. 

We like the PiShell case. It's not quite as sleek 
as the Official Case, but it's sturdy; that and 
the Camera Module integration make it a handy 
surround for your Raspberry Pi board. El 


toierbi Canl start a 


CoderDojo club 
in my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 

people the opportunity to learn to code. 


incredibly 
rewarding experience 


"| started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. | get to see them 
making new friends, learning from one other, and they loved it. 
Realising how I had created such a wonderful place for children has 
ignited a spark in me.” 

- Maroes, CoderDojo NL 


Start your own club. Join us at CoderDojo.com 


The CoderDojo Foundation is Irish Registered Charity (524255) CHY20812 ns : 
andis part of the Raspberry Pi Foundation, UK registered charity 1129409 Pare Raspberry Pi 
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10 Best: 


Get your Pi controlling your home 
with these loT gadgets 


he dream of home automation is forever present 

among makers and other tech types, and the 

Raspberry Pi has helped many people turn their 
Enterprise fantasies into a reality. Here are some kits, 
add-ons, and other gadgets that can help. El 


Automation HAT 


All-in-one automation 


If you have big home automation 
plans, or already have some 
serious loT around your 
house, you'll want to look 
into the Automation HAT: you 
can plug a lot of devices into it. 


> £29 / $31 
> magpi.cc/fgMGmr 


Energenie Pi-mote 


Remote-control plug 


A quick and easy way to do some home 
automation is to remotely control a 
mains socket with your Pi and some 
code! The Energenie Pi-mote allows 
you to do just that. 


> £17/8$18 
> magpi.cc/FepLDV 
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Home 
automation 
add-ons 


SparkFun 
EoP32 [ning 


WiFi smart home 


ESP32 is a standard that lets you use 
wireless LAN to communicate with 
the various loT/home automation 
projects you've set up. This one also 
has Bluetooth as part of it! 


> £21 / $23 
> magpi.cc/UchWDj 


Google AIY 
Voice Kit 


E Voice Kit 
Vocal commands 

We had this as a freebie with the 
magazine once - the AIY Voice Kit 
allows you to add powerful voice 
control to your Raspberry Pi, and any 
connected loT or home automation 
systems in the process. 


> £25/$20 
> magpi.cc/xDJDPp 


Pi NoIR 
Camera V2 


o 
4 


E305654 WM 
JXx02 94V-0 


T da 


See in the dark 


If you're setting up a CCTV network 
in your home, or want a front-door 
camera that works 24 hours a day, 
then the IR version of the excellent 
Pi Camera Module is for you. 


> £25/$25 
> magpi.cc/ircamera 


a 

» 
= 

= 
v 

2 
a 
n 
e 

a 


Camera v2.1 
Made in PRC A 


2 


o 
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Gravity DHT22 


Light Sensor temperature-humidity sensor 
Ambient light control Thermostats beware 

Ambient light sensors are very With stuff like Nest around, it shouldn't be too surprising how 
common (you probably have one in many people use a Raspberry Pi and a temperature sensor such 
your phone) and can be a good way as this as a thermostat for their house. As an Astro Pi project 

to slowly bring up lights, as it gets demonstrated, you can use the humidity and temperature parts 
dark outside, in a more natural way. together to detect a person. 

> £7/S9 > £10/$13 

> magpi.cc/ibSTjk > magpi.cc/PZrpfv 


Amazon 
Dash Button 


Press for anything 


A favourite among hackers is 

the Amazon Dash Button - you 
can easily use it as a remotely 
connected button that does what 
you'd like it to do. And pretty 
cheaply as well! 


> £5/$5 
» magpi.cc/SXmgpe 


Philips Hue Lights 
SparkFun 


OpenPIR Controllable bulbs 


An excellent solution for controlling your lights is to have remote- 
controllable light bulbs like the Hue! You can find our tutorial on 
how to control them with a Raspberry Pi in issue 61 (magpi.cc/641). 


Motion sensing 


Want to trigger a camera recording? . 
Or lights turning on? Or literally » Various 
anything involving seeing if > meethue.com 
something has moved in a location? 
A PIR sensor like this will help. 


> £15/$16 
> magpi.cc/rcdvXL 


AUTOMATION SOFTWARE 


While you can do a lot using Raspbian, there are dedicated 
home automation operating systems for the Pi that are already 
preconfigured. We like openHAB, which you can find here: 
openhab.org 
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Everything you need to learn 
Wolfram Language & Mathematica 


Experiment with mathematics on a Raspberry Pi using Wolfram tech. By Lucy Hattersley 


Hands-On Start to Wolfram 


Mathematica and Programming 


with the Wolfram Language 


Cliff Hastings, 
Kelvin Mischo, 
Michael 
Morrison 


Price: 
£32 / $40 


magpi.cc/oFxHFL 


Make sure you start here. This 
hands-on book, written by three 
Wolfram Language authors, is 
packed with detailed examples 
for all the impressive things you 
can do with Mathematica. 

It starts with simple input and 
output examples, but quickly 
moves on to visualising data 
with 2D and 3D graphics and 
performing advanced calculus, 
probability, and statistics. It even 
works its way up to parallel and 
GPU programs. 


Now in its eleventh edition, 
the book is fully updated. Each 
chapter has detailed instructions, 
with examples for interactive 
learning and end-of-chapter 
exercises. It's packed with tips 
and advice on how to get the 
most from Mathematica. 

Fora sneak peek, Chapter 7 
is available from the Wolfram 
website (magpi.cc/dsMnRO). 
Titled ‘Creating Interactive 
Models with a Single Command’, 
this is a good example of the kind 


y 


MATHEMATICA 


of content you'll find in the 
book. It outlines how to build 
plots with interactive sliders, 
buttons, and other controls. 

Cliff Hastings also has a 
companion video that walks 
you through some of the 
concepts talked about in the 
book (magpi.cc/XHPafc). 

This book is where most 
Mathematica users start out. 
While we don't think it's enough 
on its own, it should be your first 
point of call. El 


Make sure you bookmark 


these resources 


to read and understand almost any Wolfram 


have bookmarked. 


WOLFRAM LANGUAGE FAST TUTORIAL 


This tutorial aims to give you "what you need 
Language code”. It's a useful resource to 
> magpi.cc/fXisFe 


WOLFRAM PROGRAMMING LAB 
The Wolfram Programming lab has an 
incredible range of technical demonstrations 


and quirky uses for the language. It's a fun 
way to learn new ideas and discover new 
uses for Wolfram Language. 

> lab.wolframcloud.com 


DOCUMENTATION CENTER 
The Wolfram Language & Systems 
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Documentation Center has detailed outlines 
and examples of all the commands used.. 
> reference.wolfram.com 


An Elementary Introduction 
to the Wolfram Language 


AN ELEMENTARY 
INTRODUCT! 


Wolfram 
Language 


Stephen Wolfram Language is very 
Wolfram different from programming 

languages such as Python 
Price: and C, and learning it can be 
£15 / $20 


challenging. So this book, 
written by Stephen Wolfram (the 
founder and CEO of Wolfram 
Research), proves very helpful. 

It works more like a reference 
guide than a series of tutorials, 
with each couple of pages 
outlining a concept or feature of 
Wolfram Language. The whole 
programming language is too 
vast to be covered in a single 
book, so it doesn't feature 
everything. Instead, it's more 
like edited highlights of concepts 
you really need to know. 


magpi.cc/ gJxGni 


on TO THE 


Like most Wolfram books, 
it starts out with elementary 
mathematics before moving on 
to functions lists and working 
with data. It also covers more 
advanced elements, such as 
natural language processing 
and machine learning - in not 
enough detail for you to get a 
complete understanding, but 
certainly enough to help you get 
started with each element. 

There are even some chapters 
about debugging and advanced 
coding concepts, which is far 
beyond what you get in most 
other Mathematica resources. 
Best of all, it’s available online 
for free (magpi.cc/RdGsQV). M 


Wolfram U 


Iu) mm 


Wolfram Reading books is all well 
and good, but in order to 
Pp get a full understanding of 


Mathematica and Wolfram 
Language, it's better to 
follow a course. 

Wolfram U is packed with 
training lectures and interactive 
courses that cover the language. 
Your first stop should be the 
full interactive course for ‘An 
Elementary Introduction to 
the Wolfram Language' that 
accompanies Stephen Wolfram's 
book (magpi.cc/YdMomr). 

You get to watch a video 
demonstration of each skill, 
while the book text is displayed 
by the side and a Scratch 
Notebook enables you to work on 
code as the course material 
is delivered. 


magpi.cc/ YanBnX 


There's a huge range of 
courses, covering a wide range 
of mathematical areas, such as 
Data Science & Statistics, Image 
& Signal Processing, Modelling 
& Simulation, and Finance. 
Some courses are more detailed 
than others, and many are just 
video demonstrations. But they 
all offer an interesting take on 
using Wolfram Language and 
Mathematica, and help you 
move further along than just 
reading books. There are also 
webinars and live events where 
you can meet up with other 
Wolfram learners. El 
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Get help from other 
Wolfram users in the 
community 


WOLFRAM COMMUNITY 
The official Wolfram forum 

has official staff picks and 
announcements. Plus a vibrant 
community that's on hand to 
answer questions. 

> community.wolfram.com 


STEPHEN WOLFRAM'S 
LIVESTREAMS 

The man himself frequently 
chats about various Wolfram 
endeavours on his live-stream 
blog. And there's a whole 
back catalogue of historical 
video streams. 

> magpi.cc/QhyXuf 


MATHEMATICA 
STACKEXCHANGE 

Because Wolfram is so 
heavily invested in developing 
training resources, almost 

all of your time is spent 

using official resources. So 
don't forget to bookmark the 
StackExchange so you have at 
least one community resource 
elsewhere. It's a great 
community, too. 

> magpi.cc/NvKfac 
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In the state of West Virginia, Project 76 is trying to improve 
computer science education, thanks to its organiser Brett White 


Category 


henever a Picademy 

is put on in America, 

people from all around 
the US come to attend the course. 
One of these new Raspberry Pi 
Certified Educators, Brett White, 
is now trying to use his new skills 
to help at home. 

“Computer Science in my 
home state of West Virginia is 
pretty lacklustre,” Brett tells 
us. “My high school didn’t start 
a computer programming class 
until my senior year of high 


Day job 


school (which was in 2014). 
While that was a first for my high 
school, they did not get more 
advanced than that, and that 
class I was in taught Java, which 
in my opinion is not a great way 
to get started. Middle school 
courses for easy coding barely 
exist ... and there are few tech 
jobs in the area as a result, and 
the demand for it is definitely not 
where it should be.” 

Brett created Project 76 to help 
change this. 


One of many ESP8266- 
based devices running 
via MQTT 


This is a multi-sensory 
node for Brett's house 


What is Project 76? 
Project 76 (named after 
Bethesda’s Fallout 76, which 
is primarily based in West 
Virginia) is my goal to: 
Get more CS Classes 
introduced in high schools, 
with beginner courses 
starting in middle schools in 
West Virginia. 
Start Code Clubs in West 
Virginia High Schools so that 
students can have a chance to 
do extra-curricular projects, 


Eu. 


Middle school courses for easy coding 
barely exist, and there are few tech 
jobs in the area as a result 


and to bring these projects to 
my Statewide Raspberry Jams. 
Start area CoderDojos in 
West Virginia for anybody 
interested in projects 
(whether in school or not) to 
come down and learn how to 
do programming, and have 
CoderDojos adopted possibly 
by Universities in our area to 
support in-state education. 
Have teachers, librarians, etc. 
interested in getting Raspberry 
Pi Certifications, so we can 
have more certified teachers 
around the state to teach 
classes and do Code Clubs. 
Have access to Raspberry Pi 
and Arduino in middle, high 
schools, and higher education 
institutions, so students can 
have access to technology. 
Eventually to [encourage] 
interested tech companies to 


set up bases in West Virginia, 
because we have a lot of 
locations open, and it would 
really help our state to even 
evolve it, such as having 
internet access to many rural 
areas in our state. 

To build a makerspace in main 
cities (such as Charleston, 
Fairmont, Parkersburg), so 
anyone can use our facilities 
and hold CoderDojo classes 
and mini Raspberry Jams there 
as well. 


What have you made yourself 
with a Raspberry Pi? 

My personal projects involve 
mostly smart home. I have three 
Raspberry Pis in my house, 
running everything, such as 

a Raspberry Pi running Home 
Assistant, with additional 
add-ons for an MQTT broker, 


This Pi powers 
Home Assistant 


We love this 
makeshift 
home server 


This is a custom 
door lock, 
powered by Pi 


Node-RED, and various 
controller add-ons. I’ve also 
got a Raspberry Pi 3B+ running 
DietPi, running services such 
as a VPN, Plex Media Server, 
BitTorrent server, web front- 
end, and my motionEye security 
camera software. There’s 

also [another] Raspberry Pi 3 
running DietPi, running other 
services like OctoPrint (for 

my 3D printer), ownCloud, 
UrBackup, and Resilio Sync, 
with a desktop interface 
powered by Raspbian PIXEL. 


Brett White 


MägPi 


Picademy 
USA 


Want to become a 
Raspberry Pi Certified 
Educator in North 
America? There 

are several events 
already planned for 
this year, and you can 
find out more about 
them here: 
magpi.cc/CNKtBm 
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This Month = 
in Raspberry P1 


= EZE 


Great day in #RPiStore with @PFreakers, 
brilliant shop and service, thanks @gsholling 


Raspberry PI 
Store! d 


Members of the community have 
been visiting the new store. 
Here are some pics! 5 Mark Norwood 


@mvnorwood 


f you didn’t already see it on page 6, there is . 
| now a Raspberry Pi Store in Cambridge! As Hello lovely @Raspberry_Pi people, are there 
we send this mag to the printers, it’s only any plans to bring out matching raspberry 
been open for a week or so now, but that hasn’t | d HDMI | d d t f tc? 
stopped loads of community members from coloure eads, adap ors or zero, etc: 
making the journey down to it, as you can see Would be lovely to have matching kit (yeah, | 
mom their amazing photos Ai know I need to get the matching mouse 
next). 
#RPiStore #RPiLearn #RPi #RaspberryPi 


01. The facade is 
very minimalist #Raspb 
02. The official keyboard M ^ 


and mouse have been 
a huge hit at the store 


erryiam 


03. You can buy books 
and The MagP!! 


04. The Babbage bears 
are very popular 


05. Roger, Principal 
Hardware Engineer at 
Raspberry Pi, gets a 
look around the store 


06. Kidin a candy store! 


07. Gordon, Director of 
Software Engineering 
at Raspberry Pi, has 
been at the store a lot 


4:49 PM - 14 Feb 2019 
08. Meet members of the 


Raspberry Pi team 
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re) Carrie Anne Philbin 
@MissPhilbin 


MaágPi 


Jassen 
k d Sjpxdude 


Popped into the store at the 


I'm visiting the Raspberry Pi store in Grand Arcade today, great job 


Cambridge with the Learning Team 


#squadgoals they have some fab books on eating a raspberry in the pic). 
sale btw... SS 


M Paul Freakley 
ép Uc 
Want to know what a child feels like in a 
sweetshop? #Engineer at the #RPiStore. A 
perfect addition to retail in #Cambridge 
@Raspberry_Pi 


E Gordon Hollingworth 


Fixing software in the #RPiStore ! 


very nice! Walked out with an A+, case and 
Babbage teddy for my daughter. (She is 


(o deny roro C Follow È : < $ 


Some more pics from our sneak preview visit 
to the brand new (GRaspberry Pi store in 
Cambridge with @Roger_Thornton and 
@MikeBuffham 


Simon 
@simuk 


Just visited the world's first @Raspberry_Pi 
shop in Cambridge on the opening day! Can 
see I'll be back often to get @pimoroni 
treasure, @adafruit @thepihut and so much 
more at the #RPiStore 


2:28 PM - 7 Feb 2019 


Raspberry Pi store magpi.cc 
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P1 videos! 


Videos from us and Raspberry Pi that you may have missed 


id you know you can find us on YouTube? 
D It’s true, we put out fun tutorial and preview The e 
videos of Pi kits and projects. Find us here: Magi 
magpi.cc/youtube. Raspberry Pi itself also has a maiia. QI Magazine 
channel full of excellent videos, which you can find 
here: magpi.cc/DXRHRQ. 
Both channels are packed with great videos - 
why don't you check them out? H TOME 
Raspberry Pi 3A* * 


—Á et 


01. Meetthe Raspberry 
Pi3A* 


Still unsure of what the 
Raspberry Pi 3A+ is all 
about? Let us show you 
in this video. 
magpi.cc/rrFQBu 


02. Raspberry Pi Store 


Get a look around the 
Raspberry Pi store from 
the comfort of your 
own home. Be warned, 
though: it might make 
you want to make the 
trek to Cambridge to 
visit it. 
magpi.cc/uidcEB 


03. Defining ‘maker’ 


We get caught up in 
labels and gatekeeping 
a lot in modern society, 
so Raspberry Pi talks 
to some makers about 
how they became 
‘makers’, and what that 
means to them. 
magpi.cc/jDiZdP 


04. Jenni Sidey 
inspires young 
women in science 


To celebrate 

International Day of AN D G l R LS 
Women and Girls in . / 
Science, Raspberry Pi = 

interviewed Canadian | N S C 1 E N C E 
astronaut Jenni Sidey, = : : 

and asked why she 
thinks STEAM skills 
are important. 
magpi.cc/pDNgER 
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= Raspberry Pi project 
Crowdfund this! 275 ss. 


P118650 Smart UPS Picoh 


This add-on started life as a simple UPS/battery The Picoh is a newer, smaller version of the Ohbot 
pack for the Pi, but has since evolved far past that to we featured in the magazine way back in issue 66 
include different kinds of environmental sensors, a (magpi.cc/66). Instead of a fully mechanical face, the 
microcontroller, LEDs, pinouts for other things to add to Picoh has a digital face that is a little more friendly 

it, and many other features. Give it a look! than the original 

> kck.st/2Wqkg06 > kck.st/2RTWcwN 


Best of the rest! Here are some other great things we saw this month 


CYBERPUNK LAPTOP | SELF-DRIVING CAR PI ON THE WATER 

2019 seems to be the year of We're not here to answer the question of A remote, Pi-controlled boat with 
cyberpunk aesthetics, and we're here whether self-driving cars are the future, camera! We love this, although we 

for it. We love this laptop design that is but we do love seeing Pi-robot-sized assume the range on something like this 
camouflaged in an old mah-jong box, automatons that are programmed like self- is dependent on wireless LAN signal 
with colourful keys and exposed PCBs. driving cars. Head to the link for a fun little strength and/or the length of a cable. 
It's wonderful. video of this guy tootling around the track. Still, an amazing project. 


» magpi.cc/CCJppK > magpi.cc/vjDimi » magpi.cc/ndipGc 
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LÀ 


aspberry Jam 
vent Calendar 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. Raspberry Jam Big Birthday Weekend 


© Saturday 2 March to Sunday 3 March 

Q9 Earth, Solar System, Milky Way 

» magpi.cc/CrMUru 

Get ready to celebrate the Raspberry Pi's birthday by 
going to your local Jam! 


02. Inverell Raspberry Jam 

^ Monday 4 March 

9 TAFE NSW - Inverell Campus, Inverell, Australia 
> magpi.cc/inLLWD 

Anew weekly Raspberry Jam in Australia, where you can 
learn about Pi or get help with yours! 


03. Satellite Beach Library Pi Jam 

© Saturday 9 March 

Q Satellite Beach Library, Satellite Beach, FL, USA 
» magpi.cc/mrZtTT 

Join this family-friendly, STEAM-powered celebration of 
making, coding. creativity, play, and more! 


04. Fresno Ideaworks' Raspberry Jam 

© Thursday 14 March 

Q9 Fresno Ideaworks, Fresno, CA, USA 

> magpi.cc/VMCURi 

Projects will be on display from community members, 
and there are also beginner workshops. 
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05. ShePi Jam 


© Saturday 16 March 

9 NG Hub From Facebook, Lagos, Nigeria 

» magpi.cc/HxrdeV 

An initiative to build a community of young women 
learning and using the Raspberry Pi. 


06. Pi Wars Turkey 

© Friday 22 March to Saturday 23 March 
Q Hisar School, Istanbul, Turkey 

> piwars.hisarcs.com 

Pi Wars will soon be here in the UK, but first you can D NI 


FULL CALENDAR 


Get a full list of upcoming 
events for March and 
beyond here: 


rpf.io/jam 


head over to Istanbul for their robot challenges. 


07. Patriot Pi Raspberry Jam 
© Saturday 30 March 
Q Cherry Valley-Springfield Central School, NY, USA 


> magpi.cc/ZicaQc 
Learn and share about the Raspberry Pi, including the 


`N 


huge variety of projects and learning opportunities. 


08. Stafford Raspberry Jam 

© Tuesday 12 March 

Q Stafford Library, Stafford, UK 

» magpi.cc/iVXQyw 

A big meet-up where people of all ages get together to 
share ideas, help each other, and have fun! 
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A V) 


wa $4 FIND OUT 
$ $3 ABOUT JAMS 


Want a Raspberry Jam 


M e in ? 
your area? 
$ a a Ld 1 e 6 Want to start one? 
& 6 Email Ben Nuttall about it: 


f - l $ jam@raspberrypi.org 
TL * s 


E 


e 
& 
[os] We've highlighted some of the areas b 


in need of a Jam! Can you help out? Raspberry Jam advice: 


Reflecting on 
your first Jam 


áá W hen I ran my first Jam, I thought of it 

as being a meet-up for techie adults, 

but I decided to run the first one on a 
Saturday. When kids and families turned up, I realised 
this was a better format than I had had in mind. 
It was great to see people of all ages enthused 
by technology, so we kept the free-form E 
practical format, and it worked really well.” v- AV am 


Ben Nuttall - Manchester Raspberry Jam " o ^" 
E 


Every Raspberry Jam is entitled to apply for a 


Jam starter kit, which includes magazine issues, « 
printed worksheets, stickers, flyers, and more. GUIDEBOOK 
Get the book here: magpi.cc/2q9DHfQ 
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Your 


Letters 


Command line 


and conquer 


I've been looking at getting a 
print version of the Conquer the 
Command Line Essentials book. 
However, it looks like it's been 
out of stock on your store for a 
little while now. Iknow I can 
grab the PDF, and I have been 
using that, but I would really like 
to get the physical version as 
well. Any idea when this will be 
back in stock? 


Mark N via Facebook 


The reason the book was out 

of stock for a little while was 
because we were putting the 
final touches to our updated 
second edition of Conquer the 
Command Line, which we can 
happily announce is out now! 
You can buy it today from the 
Raspberry Pi Press store - find it 
here: magpi.cc/gMkZAn. M 


Contact us! 


> Twitter — (gTheMagPi 


» Facebook magpi.cc/facebook 


» Email 
» Online 


magpi@raspberrypi.org 
raspberrypi.org/forums 
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> our fully updated Conquer 
the Command Line book is 
now available! 


Download issues 


Just letting you know that I 

get an error when trying to 
download The MagPi #64 via the 
Download button on the issue 
page. I’ve tried over months, 
and with Firefox and Edge 
browsers on Windows 10, and 
with the same error of a secure 
connection failure. 

Also, The MagPi #16 fails to 
complete downloading. It gets to 
about 20% then fails. Again, this 
is on the issue page on your site. 

I’ve not had any issues with 
any other download links that 
I’ve used on your website. 


Robert G via email 


We do sometimes get readers 
like yourself emailing about 
issue download problems. In 
this case, in all our tests the PDF 
downloads were working fine at 
our end. If this is happening to 


you, using a different browser 
or clearing your cache will 
usually sort it out and let you 
download it. 

In Robert's case, we were not 
able to find a quick solution 
- they were fine our end and 
it could be any number of 
problems on his. So, we emailed 
him the PDFs. If you're also 
having some download issues, 
don't hesitate to contact us, and 
we'll try to figure it out! El 


A You can download free PDFs of 
The MagPi at magpi.cc/issues 
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Older articles 


I’ve been looking at the ‘Program an Arduino Uno with your Raspberry Pi’ article (magpi.cc/qvvCUY). 
I tried using Chromium, downloaded, unpacked, and installed for a part of it, but that failed. 
So I tried: 
cd Downloads/ 
tar -xf arduino-1.8.8-linuxarm.tar.xz 
sudo mv arduino-1.8.8 /opt 
sudo /opt/arduino-1.8.8/install.sh 


But that also failed, saying: 
Adding desktop shortcut, menu item and file associations for Arduino IDE..touch: cannot 
touch '/root/.local/share/applications/mimeapps.list': No such file or directory 
/usr/bin/xdg-mime: 803: /usr/bin/xdg-mime: cannot create /root/.local/share/ 
applications/mimeapps.list.new: Directory nonexistent 


How do i install version 1.8.8 on my Raspberry Pi Model 3B+? 
David H via email 


It looks like you've run into one of the unfortunate realities of tech tutorials: sometimes they go 
out of date. As technologies change and software gets updated, eventually something that did work 
might not. 

For this specific tutorial, you can achieve some success by creating the applications folder so the 
install can continue. What we recommend, though, in cases like this (which are thankfully rare in our 
tutorials!) is to visit the Raspberry Pi forums (rpf.io/forums) and the friendly folks on there can give 
better help on sorting it out. El 


Pop down the Pi shop 


What is this I hear about a new 
Raspberry Pi Store? Where is 

it? When can I go to it? Are you 
opening more? I have so many 
questions - I just would really 
love to go to an actual Raspberry 
Pi store! 


Charley N via Twitter 


There is indeed a brand new 
Raspberry Pi Store, and you can 
read more about it on page 6 (and 
see more pictures in This Month 
in Raspberry Pi on page 86). It was 
opened in Cambridge, the home 
town of the Raspberry Pi, and 

is currently the only one in the 
world! We have absolutely zero 
idea if or where more will open, 
but for the moment it's a real-life 
store in Cambridge that is open 
seven days a week. ll A Visit the first ever Raspberry Pi store in the Grand Arcade, Cambridge 
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Simple coding for total beginners 


The first 
Code Club book 
has arrived! 


Learn to code 
using Scratch, the 
block-based language 


^£ aN 9po- 


Follow step-by-step 
guides to create games 
and animations 


Use the magic glasses 
to reveal secret hints 


Includes 24 exclusive 
Code Club stickers! 


The special spiral 
binding allows 
the book to lay flat 


Raspberry Pi 


MOY 
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SN 


One of Ten 


Official Raspberry Pi 
mice and keyboards 


They're finally here! The Official 
Raspberry Pi Keyboard & Hub 
and the Official Raspberry Pi 


La 


Mouse are amazing bits of kit 
that really help you with your 
computing learning. 


Head here to enter: magpi.cc/win | Learn more: On page 11 


Terms & Conditions 


Competition opens on 27 February 2019 and closes on 27 March 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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ME Magi | THE FINAL WORD 


Helping the 
next generation 


Laura Sach on guizero, and why you should always work with children 


reating a Google map 
C pinpointing locations where 
dog poo has been found around 
Nottingham is not something I ever 
thought I would do professionally. 
However, I have the good fortune 
of working for the Raspberry Pi 
Foundation and, so far, my day job 
has legitimately involved persuading 
colleagues to run around Cambridge 
avoiding virtual zombies with a GPS- 
enabled smartphone, giving myself a 
JavaScript-enabled quiff, and modding 
my glasses to include a Raspberry Pi 
Zero time-lapse camera. Standard. 


realise that, far from the careful 
following of the instructions that 
you had in mind, your game graphics 
will be replaced with bowls of cheesy 
puffs, you'll have opera singers 
screeching every five seconds, and the 
kids will be collapsed in the corner in 
a fit of giggles. And all the better for it 
— kids are amazingly good at cheering 
you up on even the worst of days, and 
their imagination and creativity will 
always astound me. 

Anyone who runs a Raspberry Jam or 
otherwise works with kids informally, 
I salute you. I’ve got a piece of paper 


Ei Anyone who runs a Raspberry Jam or 
otherwise works with kids informally, 


| salute you Ø 


Writing educational resources 
might seem straightforward - if you 
already know how to do the thing, 
then just write down the steps, 
right? I mean, sure, anyone can 
write down some instructions, but 
it's very easy to accidentally make 
your third instruction (to paraphrase 
a popular meme) *draw the rest of 
the friggin’ owl”. 

Even if you think you’ve got 
everything just right, the first 
time you test your lovingly created 
instructions on some real kids, you’ ll 
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from a university which says I can do 
this stuff, but lots of you just wing it 
because you love what you do and want 
to share it. 


Sharing knowledge 

The Raspberry Pi community is very 
welcoming to learners of all ages. I 
enjoy sharing knowledge in ways it 
can be accessed and consumed freely, 
and I love that I can do this whilst also 
earning myself a living. The project 

I am most proud of is the guizero 
Python library, which simplifies 


Tkinter, so kids can easily create 
graphical user interfaces (GUIs). This 
was not straightforward - in fact, it 
is the first Python library I have ever 
written — but it has had more than 
100,000 downloads. 

One surprise for me was that it 
doesn't seem to just be kids who use 
guizero. I originally envisaged it being 
useful for young people, but I've seen 
all kinds of uses, a popular one being 
basic GUIs controlling LEDs and other 
physical components. 

Having never written a library 
before, it was a bit nerve-racking to 
put up my code in public and shout 
*hey everyone, come and have a 
look". I was a bit worried someone 
might come and tell me how awful it 
was, but actually lots of community 
members turned up and made helpful 
comments, contributed code, and now 
Martin O'Hanlon does more work for 
the library than I do! 

There are many other -zero 
libraries, so if you've been considering 
simplifying some software for the 
community, I'd say go for it - you'll 
learn a lot and have fun on the way. M 


Laura Sach 


Raspberry Pi Senior Learning Manager, 
creator of guizero, and casual 
Python wrangler. 


lawsie.github.io/guizero 
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